Validare la sintassi JSON

Il validatore restituisce sempre un risultato strutturato: un input corretto produce un semplice indicatore vero, mentre uno errato produce falso insieme al messaggio del parser e alla posizione, riga e colonna in cui l’analisi si è interrotta. Questa risposta prevedibile è utile negli editor, nei moduli di caricamento, nei controlli di distribuzione, nelle suite di test e in qualsiasi flusso che debba spiegare un documento JSON difettoso senza bloccarsi.

Controlli la sintassi senza modificare il documento

Un validatore sintattico deve rispondere a una domanda precisa: un parser conforme allo standard riesce a leggere esattamente questa stringa? Lo strumento passa il testo fornito direttamente al parser JSON della piattaforma. Non elimina spazi, non sostituisce virgolette, non rimuove commenti, non inserisce virgole, non riordina chiavi e non reinterpreta valori. Questa cautela è importante quando Lei verifica configurazioni o payload API, perché una correzione automatica potrebbe nascondere il difetto che continuerebbe a causare errori in produzione. Un risultato valido indica che l’intera stringa è stata accettata come un solo valore JSON, inclusi oggetti, array, stringhe, numeri, booleani e null. Un risultato non valido mantiene l’errore nell’output ordinario anziché trasformarlo in un’eccezione. Lei può quindi mostrare subito la risposta o controllare l’indicatore nel codice. Testo vuoto, contenuto aggiuntivo, commenti, stringhe tra apici singoli, virgole finali e caratteri di controllo senza escape restano invalidi perché non appartengono alla sintassi JSON.

Interpreti la posizione dell’errore segnalata

Quando l’analisi fallisce, il risultato include un oggetto di errore con un messaggio e tre coordinate. La posizione è un offset di caratteri con base zero dall’inizio della stringa JavaScript. Riga e colonna hanno base uno, quindi sono comode da mostrare in un editor o in un avviso di convalida. Ogni ritorno a capo incrementa la riga e riporta la colonna a uno. La posizione indica dove il parser ha capito di non poter proseguire; il refuso effettivo può trovarsi subito prima. Per esempio, una virgola mancante tra due proprietà viene spesso segnalata sulla virgoletta iniziale della seconda, perché lì il parser scopre che la prima non è stata seguita correttamente. Un oggetto o array incompleto viene segnalato alla fine del testo. Il messaggio può variare tra ambienti JavaScript: usi i campi numerici per la navigazione e mostri il messaggio alle persone, senza confrontarne il testo completo come categoria software permanente.

Usi il risultato in sicurezza nei moduli e nei controlli

In un modulo web, esegua la convalida prima di inviare una configurazione e sposti il cursore sulla posizione restituita quando il risultato è falso. In un flusso API, tratti la risposta come dati: prosegua solo se è valida; altrimenti alleghi riga, colonna e messaggio a un rapporto di build, a una richiesta di assistenza o a un caricamento rifiutato. Un JSON non ben formato è contenuto utente previsto, quindi riceve un risultato normale con indicatore falso, non un errore di input. La richiesta viene respinta soltanto se il campo di testo obbligatorio manca o non è una stringa, poiché non esiste una fonte JSON da esaminare. L’algoritmo è deterministico e non usa rete, modelli, casualità, orologio o stato persistente. Il tempo di esecuzione cresce linearmente con la dimensione del documento durante l’analisi e il normale calcolo della posizione. L’API costa $0.002 per richiesta, mentre la versione nel browser esegue localmente lo stesso controllo.