Lavorare con testo JSON si riduce solitamente a tre compiti diversi: renderlo leggibile, renderlo compatto o verificare che sia corretto. Sono tre operazioni distinte, anche se spesso vengono raggruppate in un unico strumento.
Formattazione (pretty-print)
La formattazione aggiunge indentazione, a capo e spazi attorno alla punteggiatura per rendere la struttura del JSON facile da leggere a occhio. È una modifica puramente estetica: non influisce sui dati, solo sulla loro rappresentazione visiva.
Minificazione
La minificazione rimuove tutti gli spazi, gli a capo e le indentazioni superflue, lasciando solo i caratteri necessari. Questo riduce la dimensione del file, importante quando si trasmettono dati in rete o si archiviano grandi volumi — la struttura dei dati in sé non cambia.
Validazione
La validazione verifica se il testo è JSON sintatticamente corretto. Errori tipici che rileva: una virgola in eccesso prima di una parentesi di chiusura, apici singoli invece di doppi, chiavi dell'oggetto senza virgolette, commenti (che lo standard JSON non prevede affatto) o parentesi non chiuse. Un JSON valido è un prerequisito perché formattazione o minificazione funzionino.
Quando serve cosa
- Formattazione — nel debug delle risposte API o nella modifica manuale dei file di configurazione.
- Minificazione — prima di inviare dati in rete o incorporarli nel codice di produzione.
- Validazione — per diagnosticare perché un parser rifiuta di leggere un file JSON.
Gli apostrofi italiani non sono un problema per il JSON (ma per chi lo tratta come SQL sì)
L'italiano è pieno di elisioni con apostrofo — "dell'azienda", "un'altra", "l'utente" — e in JSON questo non richiede alcun escaping particolare, perché le stringhe usano sempre le virgolette doppie: "nome": "l'account dell'utente" è JSON perfettamente valido così com'è. Il problema nasce quando uno sviluppatore, abituato a dover raddoppiare gli apici singoli per proteggersi dalle injection SQL, applica lo stesso escaping anche al testo che finisce in JSON: il risultato è un campo con doppi apostrofi indesiderati ("dell''azienda") che altera il testo visualizzato, pur restando sintatticamente valido.
JSON5 e JSONC non sono lo stesso JSON
Alcuni ambienti (ad esempio le configurazioni di VS Code o TypeScript) accettano virgole finali, commenti e chiavi senza virgolette — si tratta delle estensioni JSON5 o JSONC, non del JSON standard (RFC 8259). Un validatore impostato sul JSON rigoroso rifiuterà correttamente un file del genere, anche se l'editor lo "capisce".