Formattatore JSON

Cos'è JSON?

JSON (JavaScript Object Notation) è un formato leggero per lo scambio di dati, facile da leggere e scrivere per gli esseri umani e da analizzare e generare per le macchine. Nonostante il nome, JSON è indipendente dal linguaggio ed è usato praticamente da ogni moderno linguaggio di programmazione, API e sistema di database.

JSON supporta sei tipi di dati: stringhe (tra virgolette doppie), numeri, booleani (true/false), null, oggetti (coppie chiave-valore tra parentesi graffe) e array (liste ordinate tra parentesi quadre). La sua semplicità e universalità lo hanno reso il formato dominante per le API web, i file di configurazione e l'archiviazione dei dati.

Come formattare JSON

Incollare il JSON nell'area di input. Il formattatore valida la sintassi, rileva gli errori e produce un output correttamente indentato. Se il JSON non è valido, la posizione esatta dell'errore viene evidenziata per poterlo correggere rapidamente. È possibile passare tra output abbellito (leggibile) e minimizzato (compatto).

Cosa fa il formattatore JSON?

• Valida la sintassi JSON e riporta la posizione esatta degli errori.
• Abbellisce l'output con indentazione e interruzioni di riga coerenti.
• Minimizza il JSON rimuovendo tutti gli spazi bianchi non necessari per ridurre le dimensioni del file.

Errori JSON comuni

• Virgole finali dopo l'ultimo elemento in un oggetto o array — JSON non consente le virgole finali, a differenza di JavaScript.
• Virgolette singole invece di doppie — JSON richiede virgolette doppie attorno a tutte le chiavi e ai valori stringa.
• Nomi di proprietà non quotati — ogni chiave deve essere una stringa tra virgolette doppie.
• Virgole mancanti tra le coppie chiave-valore o gli elementi dell'array.
• Commenti nel JSON — la specifica JSON non supporta commenti di alcun tipo.

Lavorare con JSON in modo efficace

Quando si esegue il debug delle risposte API, formattare prima il JSON per rendere la struttura visibile. Gli oggetti profondamente annidati sono molto più facili da navigare con un'indentazione corretta. Per i file di configurazione, considerare l'uso di JSON5 o JSONC (JSON con commenti) se il tooling lo supporta.

Per file JSON di grandi dimensioni (oltre 1 MB), usare parser in streaming invece di caricare l'intero documento in memoria. Strumenti come jq (riga di comando) o cercatori di percorsi JSON online possono estrarre valori specifici da strutture complesse senza riformattare l'intero documento.

JSON vs. altri formati

Rispetto a XML, JSON è più conciso e più facile da analizzare. Rispetto a YAML, JSON è più rigoroso e meno soggetto a errori di indentazione. Rispetto a CSV, JSON gestisce dati annidati e gerarchici in modo naturale. Ogni formato ha i suoi punti di forza, ma l'equilibrio di semplicità ed espressività di JSON lo rende la scelta predefinita per le API web.

Il mio JSON è al sicuro?

Sì. Tutta l'elaborazione avviene nel browser usando la funzione JSON.parse() integrata in JavaScript. I dati non vengono mai inviati a un server. È possibile formattare in sicurezza file di configurazione sensibili, chiavi API e dati privati.

Domande frequenti

Qual è la dimensione massima di un file JSON?

La specifica JSON non definisce un limite di dimensione. I limiti pratici dipendono dal parser e dalla memoria disponibile. La maggior parte delle API web gestisce payload JSON fino a 10–100 MB senza problemi. Questo strumento basato su browser funziona bene con file fino a qualche megabyte.

JSON può contenere funzioni o date?

No. JSON supporta solo stringhe, numeri, booleani, null, oggetti e array. Le funzioni non sono valori JSON validi. Le date devono essere rappresentate come stringhe (tipicamente in formato ISO 8601 come "2024-01-15T10:30:00Z") e analizzate dall'applicazione ricevente.