Come usare il formattatore JSON
JSON (JavaScript Object Notation) è il formato di dati più usato per lo scambio tra frontend e backend. Ma il JSON copiato da un'API, da un log o da un database di solito si presenta come un'unica riga compressa, praticamente illeggibile; a volte contiene spazi e ritorni a capo superflui che occupano spazio. Questo strumento passa rapidamente da una forma all'altra.
Le quattro operazioni supportate
- Abbellire (formattare): espande il JSON compresso con rientri per livello, comodo per leggere e cercare problemi. Rientro a scelta tra 2 spazi, 4 spazi o tabulazione.
- Minificare: rimuove tutti gli spazi e i ritorni a capo non necessari, riducendo le dimensioni. Adatto a file di configurazione o parametri API.
- Eseguire l'escape come stringa: trasforma l'intero JSON in una stringa con barre rovesciate, da annidare in un altro JSON o in una stringa di codice.
- Rimuovere l'escape: riporta una stringa JSON con escape a una struttura leggibile.
Individuare gli errori di sintassi
Se il JSON incollato contiene un errore di sintassi (spesso una virgola di troppo alla fine, apici singoli o chiavi senza virgolette), lo strumento non si limita a segnalare "errore di formato", ma indica riga e colonna dell'errore, così puoi saltare subito al punto da correggere. È più pratico rispetto a molti strumenti online.
Ordinare per nome di chiave
Attivando "ordina per nome di chiave", le chiavi di ogni oggetto nell'output vengono riordinate alfabeticamente. È utile quando si confrontano risposte di API, durante il code review e nella creazione di snapshot test: due JSON con contenuto identico ma ordine dei campi diverso, dopo l'ordinamento, si possono confrontare direttamente.
Perché l'elaborazione è locale
I dati delle API contengono spesso informazioni sugli utenti, numeri d'ordine, nomi di campi interni e persino chiavi. Inviare questi contenuti a un server altrui per l'analisi è già di per sé un rischio di fuga di dati. Qui l'analisi avviene interamente nel browser, quindi tecnicamente i dati non lasciano il tuo dispositivo. Puoi verificarlo da solo nel pannello Network degli strumenti di sviluppo.
Domande frequenti
Fino a che dimensione di file JSON è supportato?
Dipende dalla memoria e dalle prestazioni del browser. In genere alcuni megabyte di JSON si aprono all'istante. Per file molto grandi (decine di megabyte) conviene usare strumenti da riga di comando: il rendering di grandi quantità di testo nel browser rallenta.
Perché il mio JSON segnala un errore pur sembrando corretto?
Le tre cause più comuni: una virgola dopo l'ultimo elemento, che lo standard JSON non ammette; apici singoli invece di doppi, mentre JSON accetta solo i doppi; e chiavi senza virgolette, legittime negli oggetti JavaScript ma non in JSON. Lo strumento indica riga e colonna esatte.
L'ordinamento cambia l'ordine degli array?
No. Vengono ordinate solo le chiavi degli oggetti; l'ordine degli elementi degli array resta invariato. È importante, perché l'ordine degli array ha spesso un significato applicativo.
Il contenuto incollato viene salvato?
No. Ricaricando la pagina scompare; non c'è alcuna memorizzazione né invio.