Formattatore JSON

Che cosa fa davvero un formattatore JSON

Il JSON arriva da un'API come una riga unica. Un formattatore JSON, detto anche beautifier o indentatore JSON, analizza quella riga, ricostruisce la struttura che descrive e la ristampa con una chiave per riga e un livello di rientro per ogni livello di annidamento. I dati non cambiano: tornano gli stessi oggetti, array, stringhe e numeri, solo disposti in modo che una persona possa leggerli.

La parte che conta è l'analisi. Per indentare il testo il formattatore deve prima capirlo, quindi un risultato che torna formattato è un risultato che era JSON valido. È per questo che formattare e validare JSON sono lo stesso controllo visto da due lati, e perché puoi incollare qui una risposta API per rispondere alla domanda «ma è valido?» prima di cercare un bug nel tuo codice.

Come formattare JSON online, passo per passo

• Incolla o apri il file incolla la risposta nel riquadro di sinistra, oppure carica un file .json dal disco con Apri file. Le risposte grandi non sono un problema: il lavoro avviene sul tuo computer, quindi non c'è attesa di caricamento né un limite di dimensione oltre la memoria del browser.
• Scegli il rientro due spazi è il valore predefinito e la convenzione più diffusa nei progetti JavaScript e TypeScript; quattro spazi si adatta a Python e Java; la tabulazione a Go. Minifica invece elimina ogni spazio superfluo, quando serve il payload più leggero possibile.
• Ordina le chiavi se devi confrontare due risposte API con gli stessi dati in ordine di chiavi diverso producono un diff pieno di rumore. Ordinale entrambe e il confronto si riduce ai campi davvero cambiati.
• Porta via il risultato Copia mette il JSON formattato negli appunti; Scarica lo salva come file .json da committare, allegare a un ticket o passare a un altro strumento.

Leggere un errore di sintassi JSON

Quando l'analisi fallisce, l'errore indica la posizione in cui il parser si è fermato: non necessariamente dove è l'errore, ma sempre dopo. Quattro cause coprono quasi tutti i casi.

• Una virgola finale gli oggetti JavaScript ammettono una virgola dopo l'ultima proprietà, il JSON no. È l'errore di JSON non valido più frequente e nasce quasi sempre dalla modifica a mano di un file di configurazione.
• Apici singoli le stringhe JSON usano solo doppi apici. 'nome' è un errore di sintassi, "nome" è una stringa.
• Una chiave senza virgolette {nome: "x"} è JavaScript valido e JSON non valido. Ogni chiave deve essere una stringa tra virgolette.
• Un'interruzione di riga dentro una stringa un vero ritorno a capo tra virgolette va scritto come \n. Di solito arriva copiando un valore su più righe da un terminale.

Quando serve un altro strumento

Il formattatore serve a leggere e verificare. Se devi estrarre un campo da un documento grande, lo strumento giusto è un'espressione JSONPath o jq. Se devi confrontare due risposte campo per campo, usa un diff JSON dopo aver ordinato entrambe qui. Se quello che hai è un JWT, il payload è Base64url dentro il token e non JSON in chiaro: decodificalo prima. E se il file è NDJSON, un documento JSON per riga, formatta una riga alla volta: l'intero file, volutamente, non è un singolo documento JSON valido.