Come validare, formattare e minificare JSON

Verifica la sintassi JSON, migliora la leggibilità e prepara una versione compatta.

Guida praticaAggiornato Tempo di lettura indicativo: 3 min
In questa pagina

JSON richiede una sintassi precisa

I nomi delle proprietà e le stringhe hanno bisogno di doppi preventivi. Non sono ammessi commenti, virgole finali, stringhe indefinite e a virgola singola.

Un esempio valido è "name":"Kitavio","local":true. Formattazione aggiunge rientro e interruzioni di riga; la minimizzazione rimuove la formattazione senza rimuovere spazi all'interno di una stringa.

Leggere un errore di convalida

In caso di guasto, controllare la posizione, la linea o la colonna segnalata quando disponibile. Una virgola mancante può causare un errore all'elemento seguente.

La formattazione non ripara automaticamente un documento non valido. Correggere l'input e convalidare di nuovo.

  1. Incolla JSON senza involucri Markdown.
  2. Scegli 2 o 4 spazi per la formattazione.
  3. Convalidare e ispezionare la struttura di uscita.
  4. Minificare solo dopo aver confermato che i dati sono corretti.

Chiavi di precisione e duplicate

Vengono utilizzati JSON.parse e JSON.stringify del browser. Gli integer oltre la precisione JavaScript possono cambiare e l'ultima chiave duplicata viene mantenuta.

Per conservare numeri molto grandi, conservarli come stringhe o utilizzare un flusso di lavoro specializzato. Lo strumento è locale; la formattazione non crittografa o anonimizza i dati.

Criteri per la revisione e la consegna del risultato

Preparare un campione che rifletta la struttura dell'applicazione: un oggetto con campi, un array e diversi tipi di valore. Rivedere la sintassi prima di modificare il contenuto per risolvere un errore. Commenti, singole citazioni e virgole finali possono appartenere a un'altra rappresentazione, ma non allo standard JSON accettato qui. Se la convalida ha esito positivo mentre un'API rifiuta il campione, confronta i campi e i tipi con il contratto di ricezione. Il parsing e l'accettazione della domanda sono controlli separati.

Formattazione e minimizzazione dell'analisi e della serializzazione dell'uso, quindi non aspettarti che ogni byte di input sopravviva. I tasti ripetuti e gli interi oltre la precisione numerica ordinaria richiedono particolare attenzione. Mantieni l'origine per le firme, gli esempi di identificatori di grandi dimensioni o le rappresentazioni esatte. Confronta il conteggio degli elementi, le stringhe con spazi e valori importanti prima e dopo l'elaborazione. L'uscita leggibile aiuta l'ispezione; l'uscita compatta si adatta ad alcuni campi tecnici. Né certifica la correttezza del business. Sostituire credenziali e dati reali con valori fittizi prima di utilizzare esempi nella documentazione pubblica. Un piccolo test rappresentativo è utile per confermare la struttura prevista preservando il set di dati originale per risolvere le discrepanze che un'anteprima formattata da sola non può spiegare.

PROVA TU

Leggere un oggetto JSON

Incolla {"ok":true,"n":2} nel formattatore e scegli due spazi di rientranza. Prova anche contacts.json.

La struttura viene validata e mostrata con rientranza, senza tradurre proprietà o valori.

Una virgola finale o una chiave senza virgolette causa un errore. La sintassi valida non verifica lo schema di un’API.