Informazioni sullo strumento
Le risposte delle API e i payload dei log arrivano quasi sempre minificati su una sola riga. Formattarli rende molto più semplice controllare nomi dei campi, annidamento e valori quando scrivi asserzioni o bug report. Questo formattatore analizza l’input con il parser JSON nativo del browser, quindi accetta esattamente ciò che accetterà JSON.parse nel tuo codice di test. Non viene caricato nulla; l’ultimo input resta salvato nel local storage del browser per comodità.
Come si usa
- Incolla il JSON nel pannello di input, oppure clicca “Load sample”.
- Scegli lo stile di rientro e, se vuoi, ordina le chiavi alfabeticamente per confrontare più facilmente due payload.
- Copia o scarica il risultato formattato. Se l’input non è valido, l’errore indica la riga e la colonna da correggere.
Correggere gli errori di sintassi JSON più comuni
La maggior parte dei casi di “JSON non valido” nasce da payload scritti a mano o copiati da codice JavaScript. Ecco le cause tipiche e come risolverle:
- Virgola finale dopo l’ultimo elemento, come in
{"a": 1,}o[1, 2,]: elimina l’ultima virgola. - Stringhe o chiavi tra apici singoli, come in
{'a': 1}: il JSON ammette solo i doppi apici. - Chiavi senza virgolette, come in
{a: 1}: ogni chiave deve essere una stringa tra doppi apici. - Commenti (
//o/* */): il JSON non prevede commenti. Rimuovili, oppure tieni la configurazione commentata in file JSONC o JSON5 letti esplicitamente dal tuo strumento. - Valori
NaN,Infinityoundefined: non sono JSON. Usanull, un numero o una stringa. - Un a capo o una tabulazione letterali dentro una stringa: usa l’escape
\no\t. - Due documenti incollati insieme, ad esempio due righe di log NDJSON: formatta una riga alla volta.
Formattare il JSON nel codice di test
Payload leggibili nei report di test rendono molto più rapida la diagnosi dei fallimenti. In JavaScript e TypeScript, JSON.stringify(value, null, 2) indenta con due spazi. In Playwright puoi allegare al report un body formattato con testInfo.attach('response', { body: JSON.stringify(json, null, 2), contentType: 'application/json' }).
In Java con Jackson usa mapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj). In Python, json.dumps(obj, indent=2, sort_keys=True). Da riga di comando, jq . response.json formatta e colora un file.
I numeri molto grandi perdono precisione
Il JSON in sé non pone limiti alla dimensione dei numeri, ma JavaScript interpreta ogni numero come float a 64 bit. Gli interi oltre 9.007.199.254.740.991 (2^53 − 1), come alcuni ID di database, vengono arrotondati senza avvisi. Poiché questo formattatore usa JSON.parse, questi ID appaiono arrotondati nell’output, e lo stesso accade nel codice di test eseguito nel browser. Le API che restituiscono ID grandi dovrebbero inviarli come stringhe, e i test dovrebbero confrontarli come stringhe.
Formattatore JSON: domande frequenti
Che cos’è un formattatore JSON?
Un formattatore JSON (o beautifier) prende un JSON compatto o disordinato e lo ristampa con rientri e a capo coerenti, così la struttura è facile da leggere. Cambia solo gli spazi, mai i dati. I tester lo usano per leggere risposte API minificate, confrontare payload e incollare esempi puliti nei bug report. Questo formattatore può anche minificare il JSON e ordinare le chiavi, e usa il parser nativo del browser, quindi accetta esattamente ciò che accetta JSON.parse.
Come si formatta un JSON online?
Incolla il JSON nel pannello di input qui sopra, oppure clicca “Load sample”. Il JSON valido viene formattato subito con il rientro che scegli (2 spazi, 4 spazi o tab) e puoi copiare il risultato. Se l’input non è valido, lo strumento mostra l’errore del parser con riga e colonna in cui l’analisi si è fermata. La formattazione avviene interamente nel browser, quindi puoi incollare tranquillamente risposte API che contengono dati di test.
Come posso validare un JSON?
Validare un JSON significa verificare che rispetti le regole di sintassi: chiavi e stringhe tra doppi apici, nessuna virgola finale, nessun commento e parentesi bilanciate. Incollarlo qui lo valida automaticamente, perché il formattatore produce output solo per JSON valido. Per verificare che un JSON valido abbia anche i campi e i tipi giusti, usa la validazione con schema, ad esempio il validatore JSON Schema. Nel codice, JSON.parse in JavaScript e json.loads in Python sollevano un’eccezione con input non valido.
Come trovo gli errori in un file JSON?
Incolla qui il contenuto e leggi la riga e la colonna segnalate. I parser si fermano dove non riescono più a proseguire, quindi l’errore reale è spesso subito prima di quella posizione: una virgola mancante tra due proprietà, un apice o una parentesi non chiusi, una virgola finale o apici singoli al posto dei doppi. Correggi il primo errore e ricontrolla, perché un errore può nasconderne altri. Il validatore JSON è pensato per segnalare gli errori nei file più grandi.
Che differenza c’è tra formattazione e validazione JSON?
La formattazione cambia l’aspetto del JSON (rientri, a capo ed eventualmente ordine delle chiavi) senza modificarne i dati. La validazione verifica se il testo è JSON corretto, e la validazione con schema va oltre, controllando che il JSON corretto abbia i campi, i tipi e i valori attesi. Un formattatore deve prima analizzare il JSON, quindi ne valida la sintassi come effetto collaterale, ma non può dirti che price dovrebbe essere un numero e non una stringa.
Esiste un formattatore JSON online gratuito?
Sì, questo. Il formattatore JSON di SDETRole è gratuito, non richiede registrazione e funziona interamente nel browser, quindi nulla di ciò che incolli viene caricato: puoi verificarlo nella scheda Network del browser. Formatta, minifica e valida il JSON e indica riga e colonna degli errori di sintassi. Tra gli strumenti gratuiti correlati ci sono il JSON diff per confrontare payload, il JSONPath tester per estrarre valori e il convertitore da JSON a CSV.
Perché il mio JSON fallisce con virgole finali o apici singoli?
Il JSON rigoroso (RFC 8259) non ammette virgole finali, stringhe tra apici singoli, commenti né chiavi senza virgolette: sono caratteristiche degli object literal di JavaScript. Rimuovili, oppure chiedi al responsabile dell’API di restituire JSON valido.
Ordinare le chiavi cambia il significato del JSON?
No. Nel JSON l’ordine delle chiavi di un oggetto non ha significato, quindi ordinarle è sicuro per il confronto. L’ordine degli array invece conta e non viene mai modificato.