Formattatore JSON

Cos'è un JSON formatter?

Un JSON formatter (chiamato anche JSON beautifier o pretty-printer) prende un JSON compatto o disordinato e lo trasforma in dati leggibili e indentati. È uno degli strumenti per sviluppatori più usati: serve per esaminare le risposte delle API, leggere file di configurazione, fare debug dei log, confrontare i dati di test e spostare dati tra codice frontend e backend.

Il JSON è un formato rigoroso: le chiavi devono stare tra virgolette doppie, le stringhe pure, le virgole devono essere al posto giusto e ogni { o [ aperta deve essere chiusa. Un formatter rende visibile questa struttura, e un validatore integrato ti dice esattamente dove si rompe la sintassi, se si rompe.

JSON sta per JavaScript Object Notation. Anche se è nato da JavaScript, quasi ogni linguaggio di programmazione ha un supporto integrato per leggere e scrivere JSON, ed è per questo che è diventato il modo predefinito di scambiare dati strutturati sul web.

Cosa imparerai usandolo

• Gli oggetti usano {} per i campi con nome, gli array usano [] per le liste ordinate, e possono essere annidati gli uni negli altri a qualsiasi profondità.
• Il JSON formattato e quello minificato sono *gli stessi dati*: gli spazi cambiano la leggibilità, non il significato. I server di solito restituiscono JSON minificato per risparmiare byte.
• I valori JSON sono limitati a sei tipi: stringa, numero, booleano, null, oggetto e array. Non esistono undefined, funzioni né commenti.
• Gli errori di validazione di solito indicano un punto vicino al problema, ma il vero errore (una parentesi non chiusa, una virgoletta mancante) può trovarsi qualche carattere prima.

Come formattare un JSON passo dopo passo

1. 1

   Incolla il tuo JSON nella casella di input

   Copia il JSON dalla risposta della tua API, da un file di log o da una configurazione e incollalo a sinistra. Il formatter accetta sia input minificati sia parzialmente formattati.

2. 2

   Scegli la larghezza dell'indentazione

   Due spazi è lo stile più comune; anche quattro spazi è molto diffuso. Scegli quello che corrisponde allo stile già usato nel tuo progetto.

3. 3

   Leggi il risultato della validazione

   Se il JSON è valido, l'output formattato appare a destra. Se non lo è, il messaggio di errore ti indica la riga e il carattere in cui il parsing è fallito.

4. 4

   Esplora la vista ad albero

   Usa l'albero comprimibile per chiudere oggetti e array molto annidati. È il modo più veloce per capire la forma di una risposta API che non conosci.

5. 5

   Copia o minifica il risultato

   Copia la versione formattata nel tuo codice o nella documentazione, oppure minificala di nuovo su una sola riga per salvarla o trasmetterla in rete.

Riferimento rapido della sintassi JSON

L'insieme completo dei mattoni del JSON. Tutto ciò che non è in questo elenco non è JSON valido. Specifica: RFC 8259 e ECMA-404.

Esempi di JSON da provare

{"user":{"id":7,"name":"Maya"},"skills":["HTML","JavaScript"]}

{  "user": {    "id": 7,    "name": "Maya"  },  "skills": ["HTML", "JavaScript"]}

{  "name": "Coddy",  "active": true,}

{  "count": 3,  "countText": "3",  "enabled": true}

{  "data": {    "orders": [      { "id": 101, "items": [{ "sku": "A", "qty": 2 }] },      { "id": 102, "items": [] }    ]  }}

Errori comuni con il JSON

• Usare virgolette singole invece delle doppie attorno a chiavi o stringhe: il JSON ammette solo virgolette doppie.
• Trattare il JSON come un oggetto JavaScript: commenti, funzioni e undefined non sono validi nel JSON, e le virgole finali fanno fallire il parsing.
• Dimenticare che i numeri in JSON non possono avere un + iniziale, zeri iniziali (tranne 0 stesso) o stare tra virgolette se vuoi davvero un tipo numerico.
• Incollare token, dati dei clienti o segreti di produzione in strumenti che caricano il tuo input. Il formatter di Coddy funziona in locale, quindi è sicuro, ma controlla sempre prima di usare un sito di terzi.

Domande frequenti sul JSON formatter