Come formattare il JSON: guida pratica per principianti

Il JSON (JavaScript Object Notation) è il formato di scambio dati più utilizzato nelle applicazioni web moderne. Che sia uno sviluppatore esperto o un principiante, saper leggere, scrivere e formattare correttamente il JSON è una competenza essenziale.

Cos'è il JSON

Il JSON è un formato testuale leggero per lo scambio di dati, indipendente dal linguaggio di programmazione. Si basa su due strutture fondamentali:

• Oggetti: coppie chiave-valore racchiuse tra parentesi graffe {}
• Array: liste ordinate di valori racchiuse tra parentesi quadre []

Esempio di JSON valido

Un oggetto JSON ben formattato potrebbe apparire così:

{
  "nome": "Mario Rossi",
  "eta": 35,
  "citta": "Roma",
  "interessi": ["calcio", "cucina", "viaggi"],
  "attivo": true
}

Regole di sintassi

Per scrivere JSON valido, è necessario rispettare alcune regole fondamentali:

• Le chiavi devono essere stringhe tra virgolette doppie.
• I valori possono essere: stringhe, numeri, booleani (true/false), null, oggetti o array.
• Non sono ammessi commenti.
• Non è consentita la virgola dopo l'ultimo elemento (trailing comma).
• Le stringhe utilizzano esclusivamente le virgolette doppie, mai quelle singole.

Errori comuni

Gli errori più frequenti nella scrittura del JSON includono:

• Virgola finale: {"a": 1, "b": 2,} — la virgola dopo 2 è un errore.
• Virgolette singole: {'nome': 'Mario'} — non è JSON valido.
• Chiavi senza virgolette: {nome: "Mario"} — la chiave deve essere tra virgolette.
• Commenti: // commento — il JSON non supporta commenti.

Perché formattare il JSON

Un JSON compatto su una sola riga è difficile da leggere. La formattazione (o «pretty printing») aggiunge indentazione e interruzioni di riga, rendendo la struttura immediatamente comprensibile. Questo è particolarmente utile durante il debug delle API e l'analisi delle risposte dei server.

Utilizzi il nostro formattatore JSON online per validare e formattare istantaneamente il Suo codice JSON.