JSON

Che cos'è JSON?

JSON (JavaScript Object Notation) è un formato leggero di scambio dati basato su testo, facile da leggere e scrivere per gli esseri umani e semplice da analizzare e generare per le macchine. Originariamente derivato da JavaScript, JSON è indipendente dal linguaggio ed è ora lo standard de facto per lo scambio di dati sul Web.

JSON rappresenta i dati come coppie chiave-valore organizzate in oggetti e array. La sua semplicità lo ha reso il formato dominante per le API REST, i file di configurazione e l'archiviazione dei dati.

Breve storia

JSON è stato formalizzato da Douglas Crockford all'inizio degli anni 2000. La specifica è stata pubblicata su json.org nel 2001. RFC 4627 è seguito nel 2006, e l'attuale standard ECMA-404 nel 2013.

Prima di JSON, XML era il formato di scambio dati dominante sul Web. Il minimalismo di JSON — nessun attributo, istruzioni di elaborazione o namespace — lo ha reso immediatamente popolare. Entro il 2010, JSON aveva ampiamente sostituito XML per le API Web.

Tipi di dati JSON

JSON supporta esattamente sei tipi di dati. Ogni valore in un documento JSON valido deve essere uno di questi:

{
  "string":  "hello world",
  "number":  42,
  "float":   3.14,
  "boolean": true,
  "null":    null,
  "array":   [1, 2, 3],
  "object":  { "nested": "value" }
}

Regole di sintassi JSON

JSON ha regole di sintassi rigide. Una piccola deviazione causa un errore di analisi. Queste sono le sei regole più importanti:

JSON non valido vs. valido

{
  'name': 'Alice',       // single quotes — invalid
  age: 30,              // unquoted key — invalid
  "scores": [1, 2, 3,], // trailing comma — invalid
  "note": undefined     // undefined — invalid
}

{
  "name": "Alice",
  "age": 30,
  "scores": [1, 2, 3],
  "note": null
}

JSON nel Web moderno

API REST

JSON è il formato di corpo standard per le richieste e le risposte delle API REST. Praticamente tutti i linguaggi di programmazione hanno un parser JSON integrato.

File di configurazione

package.json, tsconfig.json, .eslintrc e molti altri strumenti per sviluppatori usano JSON per la configurazione.

Database NoSQL

I database documentali come MongoDB, CouchDB e Amazon DynamoDB archiviano i dati come documenti JSON.

Stato e dati del frontend

localStorage e sessionStorage memorizzano stringhe, quindi JSON.stringify/JSON.parse vengono costantemente usati per serializzare oggetti JavaScript.

JSON vs. altri formati

JSON non è sempre la scelta migliore. Ecco come si confronta con altri formati di dati comuni:

JSON Schema

JSON Schema è un vocabolario per validare la struttura dei documenti JSON. Uno schema descrive i tipi previsti, i campi obbligatori e i vincoli di un valore JSON.

Strumenti come ajv (JavaScript), jsonschema (Python) e validatori integrati in molti IDE supportano JSON Schema. OpenAPI usa JSON Schema per descrivere i corpi delle richieste e risposte API.

Insidie comuni di JSON

Domande frequenti