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.
- Incolla JSON senza involucri Markdown.
- Scegli 2 o 4 spazi per la formattazione.
- Convalidare e ispezionare la struttura di uscita.
- 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.
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.