Formattatore JSON e Validatore

Come usarlo

JSON (JavaScript Object Notation) è il formato di testo standard per lo scambio di dati strutturati tra API, file di configurazione e applicazioni — è costruito da oggetti (coppie chiave-valore tra parentesi graffe), array (elenchi ordinati tra parentesi quadre) e una manciata di tipi di valore: stringhe, numeri, booleani, null e oggetti annidati o array. Poiché è solo testo, una singola virgola mancante o un carattere fuori posto rende l'intero documento illeggibile a un parser. La formattazione e la validazione risolvono due problemi diversi: la formattazione (pretty-printing) rientra il testo in modo che la sua struttura sia ovvia a occhio umano, mentre la validazione verifica che il testo sia effettivamente JSON sintatticamente corretto prima che qualsiasi codice cerchi di analizzarlo. Immaginati un piccolo oggetto che arriva da un'API su una sola riga, accoppiando una chiave "user" con la stringa "ada", una chiave "active" con il booleano true, e una chiave "roles" con l'array ["admin", "editor"] — tutto compresso insieme senza spazi. Formattandolo con un'indentazione a 2 spazi mette ogni chiave sulla sua propria riga indentata, una sotto l'altra, così le voci "user", "active" e "roles", più l'array dei ruoli annidato, sono tutte facili da scansionare a prima vista. La minimizzazione fa il contrario: rimuove ogni spazio, tabulazione e interruzione di riga che il formato non richiede, collassando la versione formattata direttamente nella stringa compatta originale. La minimizzazione non cambia il significato dei dati — rimuove solo gli spazi bianchi che esistono per la leggibilità umana, motivo per cui è sicuro minimizzare prima di inviare JSON sulla rete ma inutile minimizzare prima di leggerlo tu stesso. La validazione cattura gli errori che sono facili da fare a mano e facili da perdere d'occhio: una virgola finale dopo l'ultimo elemento in un oggetto o array (valida nei letterali di oggetto JavaScript, non valida in JSON), chiavi di oggetto scritte senza virgolette, stringhe racchiuse tra virgolette singole invece di doppie, e una parentesi quadra o graffa che è stata aperta ma mai chiusa. La grammatica di JSON non ha tolleranza per nessuno di questi — a differenza di JavaScript, che accetta sintassi più lasca, un parser JSON rifiuta l'intero documento al primo errore che trova. Correggere JSON non valido di solito significa elaborare gli errori dall'alto: aggiungi virgolette doppie attorno a chiavi e valori stringa, rimuovi l'ultima virgola prima di una parentesi quadra o graffa di chiusura, e conta le parentesi graffe per assicurarti che ogni apertura abbia una chiusura. La dimensione dell'indentazione è una questione di convenzione piuttosto che di correttezza — 2 spazi sono comuni in JavaScript/TypeScript e nei file di configurazione web perché mantengono gli oggetti profondamente annidati più stretti, 4 spazi sono più comuni negli strumenti adiacenti a Python e nelle guide di stile che danno priorità alla separazione visiva tra i livelli, e i tab lasciano che ogni lettore renderizzi la larghezza che preferisce. Nessuno di questi influenza il modo in cui il JSON si analizza; scegli quello che corrisponde al file che stai modificando o alla convenzione che il tuo team già usa. La formattazione e la validazione di JSON si presentano costantemente: il debug di una risposta API che è arrivata minimizzata in una scheda di rete, il controllo di un file di configurazione modificato a mano (come un package.json o tsconfig.json) prima che rompa una build, la pulizia di JSON copiato da una riga di log o da un messaggio di errore in modo che sia leggibile, e la minimizzazione di JSON prima di memorizzarlo o trasmetterlo per risparmiare byte di un payload — anche una riduzione modesta si somma tra milioni di richieste.

Domande frequenti

Il mio JSON viene inviato a un server?

No. La formattazione, la minimizzazione e la validazione avvengono tutto nel tuo browser — i tuoi dati non lasciano mai il tuo dispositivo.

Cosa controlla il validatore?

Analizza il tuo testo come JSON rigoroso e segnala il primo errore di sintassi, inclusa la riga e la colonna in cui è stato trovato quando il tuo browser lo fornisce.

Qual è la differenza tra formattazione e minimizzazione?

La formattazione aggiunge indentazione e interruzioni di riga per rendere JSON leggibile; la minimizzazione rimuove tutti gli spazi bianchi non necessari per renderlo il più piccolo possibile.

Come risolvo un JSON non valido?

Leggi prima il messaggio di errore — di solito punta alla riga e alla colonna in cui l'analisi non è riuscita. Le cause più comuni sono una virgola finale prima di una parentesi quadra o graffa di chiusura, chiavi di oggetto o valori stringa racchiusi tra virgolette singole invece di doppie, e una parentesi quadra di chiusura mancante. Correggi il primo errore, valida di nuovo e ripeti fino a quando il documento si analizza correttamente.