Formattatore e validatore JSON

Leggere il JSON di qualcun altro senza perdere la testa

La maggior parte del JSON che incontri nel lavoro reale non è mai stata pensata per gli occhi umani: una risposta API arriva come un'unica riga enorme, un file di configurazione è stato minificato da uno script di build, una voce di log ha un payload compresso al suo interno. L'abitudine che ripaga è semplice: prima incolla, poi leggi. Una volta formattato, l'indentazione ti mostra la forma dei dati prima ancora che tu legga un solo valore: quanto è profondo l'annidamento, quali parti sono array di elementi ripetuti e quali sono impostazioni singole. Quel colpo d'occhio strutturale spesso risponde da solo alla domanda, perché il campo che stavi cercando si scopre trovarsi dentro un oggetto diverso da quello che avevi ipotizzato. Formattarlo non cambia nulla nei dati — cambia solo lo spazio bianco — quindi la copia formattata si può incollare tranquillamente al posto giusto, ovunque servisse.

Quando il JSON è valido ma sembra comunque sbagliato

Due cose confondono regolarmente le persone anche dopo un parsing riuscito. La prima è il JSON dentro il JSON: un campo stringa il cui valore è a sua volta un blocco di JSON con escape, pieno di coppie backslash-e-virgolette. Non è corruzione: qualche sistema ha memorizzato un documento come testo dentro un altro documento. Copia la stringa interna e formattala da sola per leggerla. La seconda sono i numeri grandi. JSON stesso permette interi di qualsiasi dimensione, ma JavaScript memorizza i numeri come float a 64 bit, quindi un ID più lungo di circa quindici o sedici cifre può cambiare silenziosamente le sue ultime cifre durante il parsing. Se formatti un payload e un lungo ID numerico esce leggermente diverso, è per questo motivo — ed è il motivo per cui le API ben progettate inviano gli ID lunghi come stringhe.

A cosa serve davvero Minifica

Il JSON minificato è pensato per le macchine e per gli spazi ristretti: un payload incollato in un comando curl, un valore compresso in una variabile d'ambiente o in un'unica colonna di database, una risposta che vuoi il più piccola possibile sulla rete. Formattare e minificare sono perfetti opposti speculari l'uno dell'altro: puoi far rimbalzare gli stessi dati tra i due per tutto il giorno e a cambiare sarà solo lo spazio bianco. Un flusso di lavoro ordinato che usa entrambi: formatta per leggere e modificare, minifica per spedire. E se i tuoi dati sono nati come un foglio di calcolo piuttosto che come JSON fin dall'inizio, il convertitore da CSV a JSON trasforma le righe in un array di oggetti — incollare qui il suo risultato è un modo rapido per confermare che venga interpretato correttamente prima ancora che il tuo codice lo veda.

I soliti sospetti quando il JSON non passa il parsing

JSON è più rigido di JavaScript: le chiavi devono stare tra virgolette doppie, niente virgola dopo l'ultimo elemento, niente commenti e niente virgolette singole. Il validatore qui funziona mentre digiti e ti dice riga e colonna del primo problema che incontra.