La validazione JSON è il processo di verifica che una stringa di testo sia conforme alla specifica JSON. Un documento JSON valido ha la sintassi corretta: stringhe correttamente tra virgolette, nessuna virgola finale, nessun commento e un singolo elemento radice. La validazione ti indica immediatamente se il tuo JSON può essere analizzato — e se no, esattamente dove si trova il problema.
Il JSON non valido rompe silenziosamente API, caricatori di configurazione e pipeline di dati. Una singola virgola mal posizionata può impedire l'avvio di un'intera applicazione. Rilevare questi errori in fase di sviluppo — non in produzione — è la differenza tra un rilascio fluido e un'interruzione del servizio.
📍
Posizione esatta dell'errore
Il validator non ti dice solo che il JSON è invalido, ma identifica la riga e la colonna esatte in cui si verifica l'errore, così puoi andare direttamente al problema.
⚡
Validare mentre si digita
La validazione in tempo reale fornisce feedback istantaneo mentre si modifica. Vedrai gli errori scomparire man mano che li correggi — senza bisogno di cliccare su un pulsante.
🔍
Distinguere sintassi da logica
La validazione JSON rileva solo errori di sintassi. Conferma che il documento è analizzabile, indipendentemente dal fatto che i valori siano semanticamente corretti per la tua applicazione.
🔒
Privato per design
Tutta la validazione viene eseguita nel tuo browser. Credenziali, chiavi API e payload sensibili non vengono mai inviati a un server.
Errori comuni di validazione JSON
Questi quattro errori rappresentano la grande maggioranza dei fallimenti di validazione JSON:
Virgola finale
Una virgola dopo l'ultimo elemento in un oggetto o array. Valida in JavaScript ma strettamente vietata in JSON.
json
{ "a": 1, "b": 2, }
Stringhe con virgolette singole
Le virgolette singole non sono valide in JSON. Sia le chiavi che i valori devono usare virgolette doppie.
json
{ 'key': 'value' }
Undefined e NaN
undefined, NaN e Infinity sono valori JavaScript ma non sono JSON valido. Usa null o una stringa numerica al loro posto.
json
{ "val": undefined }
Chiavi senza virgolette
JSON richiede che tutte le chiavi degli oggetti siano stringhe tra virgolette doppie. Gli identificatori nudi come negli oggetti JavaScript non sono consentiti.
json
{ key: "value" }
Casi d'uso comuni
Verifica dei contratti API
Valida i corpi di richiesta e risposta rispetto alle forme attese per individuare bug di integrazione prima che raggiungano la produzione.
QA dei file di configurazione
Valida package.json, tsconfig.json e altri file di configurazione prima di fare commit per assicurarti che vengano analizzati correttamente.
Validazione della pipeline di dati
Verifica che i dati acquisiti da fonti esterne o upload degli utenti siano sintatticamente corretti prima dell'elaborazione.
Controllo pre-volo CI/CD
Esegui la validazione JSON come fase di build per impedire il deploy di file di configurazione non validi.
Apprendimento e debugging
Usa il validator come strumento di apprendimento per capire perché specifici pattern di sintassi JSON sono o non sono validi.
QA del JSON generato
Verifica che il JSON prodotto da generatori di codice, template o serializzatori sia correttamente formato prima dell'uso.
Domande frequenti
Qual è la differenza tra validazione JSON e validazione di schema JSON?
La validazione JSON (ciò che fa questo strumento) verifica la sintassi — se il documento è JSON analizzabile. La validazione di schema JSON è un passaggio separato che verifica se i valori sono conformi a una struttura, tipi e vincoli definiti.
JSON5 o JSONC sono JSON valido?
No. JSON5 (consente virgolette singole, commenti, virgole finali) e JSONC (consente commenti) sono superset di JSON ma non sono JSON standard valido. Questo strumento valida secondo la specifica JSON rigorosa (RFC 8259).
Perché il mio JSON non viene analizzato anche se sembra corretto?
Le cause invisibili più comuni sono: una virgola finale dopo l'ultima proprietà, un byte-order mark (BOM) all'inizio del file o una stringa con virgolette singole. Incolla il tuo JSON nel validator per individuare la posizione esatta.
JSON può contenere commenti?
No — la specifica JSON (RFC 8259) vieta esplicitamente i commenti. Se hai bisogno di commenti nei file di configurazione, usa JSONC o JSON5 localmente, poi rimuovi i commenti prima di serializzare.
Qual è un valore radice JSON valido?
Qualsiasi valore JSON può essere la radice: un oggetto {}, un array [], una stringa, un numero, true, false o null. In pratica la maggior parte delle API usa un oggetto o array alla radice, ma tutti e sei i tipi sono sintatticamente validi.