Validatore e abbellitore JSON

Il Validatore e abbellitore JSON è uno strumento gratuito che verifica la validità sintattica del codice JSON e formatta i contenuti validi per renderne più leggibile la struttura.

A cosa servono la validazione e la formattazione del JSON?

La validazione verifica che i dati inseriti rispettino la grammatica JSON, mentre la formattazione dispone oggetti e array validi usando spaziatura e rientri coerenti. È utile per eseguire il debug delle risposte API, controllare una configurazione prima della distribuzione o leggere dati compatti forniti da terzi.

La sintassi JSON è più rigida di quella dei valori letterali oggetto di JavaScript. I nomi delle proprietà devono essere racchiusi tra virgolette doppie, le stringhe non possono usare apostrofi e né gli oggetti né gli array possono terminare con una virgola. Anche i commenti, undefined, NaN e Infinity non fanno parte della specifica JSON.

Questo strumento usa sul server la funzione json_decode di PHP. I dati inseriti vengono trasmessi al server tramite HTTPS e non vengono archiviati. Lasciano comunque il tuo dispositivo, quindi rimuovi password, token di accesso e dati personali se le regole della tua organizzazione non ne consentono l'invio a un server esterno.

Come posso validare e formattare il JSON?

Incolla il contenuto nel campo JSON ed esegui lo strumento. Per ottenere un risultato utile, inserisci un valore JSON completo, non una parte di un oggetto copiata da una riga di log.

1. Copia la risposta grezza, il blocco di configurazione o un altro valore JSON senza le eventuali etichette aggiunte dalla console.
2. Incollalo nel campo JSON, mantenendo inalterate le virgolette e le sequenze di escape.
3. Avvia la validazione e controlla il risultato formattato oppure l'errore segnalato.
4. Se la validazione non riesce, correggi il primo errore di sintassi evidente e riprova. Una sola virgoletta mancante può far interpretare in modo errato molti dei caratteri successivi.

I quattro caratteri di spaziatura consentiti tra i token JSON, spazio (U+0020), tabulazione (U+0009), avanzamento riga (U+000A) e ritorno a capo (U+000D), non sono significativi. Puoi quindi aggiungerli o rimuoverli senza modificare i dati. Gli spazi all'interno di una stringa tra virgolette fanno invece parte dei dati e devono rimanere invariati. Anche la punteggiatura nelle stringhe viene conservata, sebbene virgolette, barre rovesciate e caratteri di controllo richiedano la sequenza di escape appropriata.

Come si interpreta il risultato della validazione?

Un risultato positivo indica che PHP è riuscito a decodificare i dati come JSON. Un errore significa invece che il parser non ha potuto interpretarli come un singolo valore JSON completo e valido. La formattazione rende poi visibili i livelli di nidificazione e i confini di oggetti e array validi.

Tra le cause di errore più comuni ci sono:

• una virgola finale prima di } o ];
• un nome di proprietà senza virgolette, come {name: "Ada"};
• stringhe racchiuse tra apostrofi;
• una virgola mancante tra proprietà o elementi di un array;
• una virgoletta doppia o una barra rovesciata senza escape all'interno di una stringa;
• un oggetto, un array o una stringa incompleti;
• dati UTF-8 non validi o un carattere di controllo non sottoposto a escape all'interno di una stringa;
• una parte intera con zeri iniziali superflui, come 01 o -01, oppure valori non ammessi in JSON, come NaN.

Un campo vuoto non è JSON valido. Al contrario, un valore isolato come 42, true, null o "hello" è JSON valido, anche se non è un oggetto né un array. Anche un contenuto con troppi livelli di nidificazione può superare il limite del decoder.

La validazione sintattica non conferma che i dati rispettino il contratto di un'API. Un documento può essere JSON valido ma contenere una stringa dove l'applicazione si aspetta un numero, omettere una proprietà obbligatoria o usare un formato di data non accettato. Per verificare questi requisiti, usa JSON Schema o i controlli previsti dall'applicazione.

Esempi pratici di JSON

Dati compatti validi:

{"name":"Ada","active":true,"roles":["admin","editor"]}

Il risultato formattato dispone le proprietà e gli elementi dell'array su livelli separati e rientrati. I valori rimangono rispettivamente una stringa, un valore booleano e un array. La formattazione cambia la presentazione, non i tipi di dati sottostanti.

Dati non validi con una virgola finale:

{"name":"Ada","active":true,}

La validazione non riesce perché JSON non consente una virgola dopo l'ultima proprietà. Rimuovila per rendere valido l'oggetto.

Le stringhe JSON possono contenere direttamente lettere accentate e caratteri non latini, purché i dati siano UTF-8 validi. Per esempio, {"city":"Zürich","greeting":"こんにちは"} è valido. Anche la notazione di escape JSON \u00fc è una rappresentazione valida di determinati caratteri Unicode, ma per i caratteri esterni al Basic Multilingual Plane sono necessarie coppie di surrogati.

Quando non serve formattare il JSON?

La formattazione è superflua se il JSON verrà letto soltanto da una macchina e non è prevista alcuna verifica manuale o revisione tramite controllo di versione. Rientri e interruzioni di riga aggiuntivi aumentano il numero di byte trasferiti, quindi le risposte negli ambienti di produzione vengono comunemente inviate in formato compatto.

È poco utile anche minificare un JSON già compatto. Ripetere la minificazione non può abbreviare nomi di proprietà fissi o valori stringa, mentre modificare questi valori cambierebbe i dati. Per il codice JavaScript da distribuire, invece dei dati JSON, l'operazione più adatta è quella offerta dal Minificatore JS.

La formattazione è particolarmente utile per esaminare strutture e valori JSON durante il debug, la revisione del codice e i controlli precedenti alla distribuzione. Evidenzia problemi nei livelli di nidificazione, semplifica la consultazione di array di grandi dimensioni e produce diff più leggibili quando la configurazione viene salvata in Git. Non corregge automaticamente il JSON malformato e non può stabilire quale fosse il significato previsto di un frammento ambiguo.

Domande frequenti

Si possono inserire commenti nel JSON?

No. Il formato JSON standard non prevede una sintassi per i commenti, quindi // comment e /* comment */ fanno fallire la validazione. Se ti servono commenti in un file di configurazione, usa un formato che li supporti oppure rimuovili prima di passare il contenuto a un parser JSON rigoroso.

I nomi di proprietà duplicati vengono rifiutati?

Non necessariamente. Secondo la specifica JSON, i nomi dei membri di un oggetto dovrebbero essere univoci, ma i parser non considerano sempre i duplicati come errori di sintassi. La decodifica PHP conserva comunemente l'ultimo valore, quindi individua i duplicati prima della validazione se è importante mantenere ogni occorrenza.

Posso validare un file JSON Lines?

Non come un unico documento JSON. JSON Lines, chiamato anche NDJSON, contiene un valore JSON distinto su ogni riga, mentre un normale parser JSON si aspetta un solo valore al livello principale. Valida ogni riga separatamente oppure converti i record in un unico array JSON.

L'ordine delle proprietà di un oggetto JSON è importante?

Le applicazioni non dovrebbero fare affidamento sull'ordine delle proprietà degli oggetti JSON. Gli array sono ordinati, mentre gli oggetti rappresentano raccolte di membri con nome. Un altro parser o serializzatore potrebbe restituire questi membri in un ordine diverso. Se la sequenza ha un significato, inserisci i valori in un array.

Perché un file JSON non viene validato anche se sembra corretto?

Un indicatore dell'ordine dei byte invisibile, una codifica UTF-8 non valida o un carattere di controllo senza escape possono far fallire la validazione di un contenuto apparentemente corretto. Anche la copia da un terminale può introdurre prefissi, come etichette di stato o timestamp. Esamina i byte originali oppure apri il file in un editor in grado di mostrare la codifica e i caratteri di controllo.

Controlli finali

Prima di distribuire il JSON corretto, confronta i tipi di dati oltre ai valori visibili, verifica che le sequenze di escape non siano cambiate ed esegui l'applicazione che utilizzerà i dati o la relativa validazione dello schema. Quando analizzi dati forniti da terzi, conserva una copia inalterata della risposta originale, così la formattazione non nasconderà l'origine dell'errore.