Vai al contenuto
🛠️
Whiz Tools

Formattatore JSON: Minimizza e Abbellisci JSON Online Gratuitamente

Formattatore JSON gratuito per minimizzare e abbellire JSON istantaneamente. Comprimi JSON, convalida la sintassi e stampa in modo elegante con rientro corretto. Strumento veloce e sicuro basato sul browser.

Formattatore JSON

Calcolatore di caricamento...
📚

Documentazione

Formattatore JSON: minimizza e abbellisci il JSON

Un formattatore JSON è uno strumento che riscrive il testo JSON con una disposizione diversa senza modificare i dati contenuti. Questo formattatore JSON svolge due operazioni: minimizza il JSON rimuovendo gli spazi bianchi superflui e lo abbellisce aggiungendo rientri e interruzioni di riga per renderlo leggibile.

Che cos'è il JSON?

JSON, abbreviazione di JavaScript Object Notation, è un formato testuale per archiviare e inviare dati. I server web lo usano per inviare informazioni ad applicazioni e browser. I programmi lo usano per i file delle impostazioni. Memorizza i dati come oggetti, scritti con parentesi graffe {}, e array, scritti con parentesi quadre []. All'interno di un oggetto, ogni dato ha un nome, chiamato chiave, e un valore. Un valore può essere una stringa, un numero, true, false, null oppure un altro oggetto o array.

Un piccolo oggetto JSON è simile al seguente:

1{
2  "name": "John Doe",
3  "age": 30,
4  "isEmployee": true
5}
6

Come funziona questo formattatore JSON

Alcuni strumenti JSON leggono il testo in una struttura dati propria di un linguaggio di programmazione e poi riscrivono quella struttura come testo. Questo passaggio di andata e ritorno può modificare i dati. Può riscrivere numeri molto grandi, eliminare numeri troppo grandi per essere rappresentati e riordinare le chiavi di un oggetto.

Questo strumento evita il problema. Legge l'input carattere per carattere e verifica che segua la grammatica JSON. Quando riscrive l'output, copia ogni numero e ogni stringa esattamente come sono stati digitati, nello stesso ordine. La minimizzazione o l'abbellimento di un documento non modifica mai un numero, una chiave, l'ordine delle chiavi o una chiave duplicata.

Se il testo non è JSON valido, lo strumento si arresta e mostra un errore invece di cercare di indovinare il significato.

La formattazione avviene nel browser. Lo strumento non invia il testo incollato a un server. L'input viene aggiunto all'indirizzo web della pagina come parametro di query, quindi un documento formattato può essere condiviso o aggiunto ai segnalibri tramite un link.

Come minimizzare il JSON

  1. Incolla il JSON nella casella di input.
  2. Fai clic su "Minify".
  3. Lo strumento rimuove spazi, tabulazioni e interruzioni di riga tra i token e mostra il risultato sotto.
  4. Fai clic su "Copy" sopra il risultato per copiarlo.

Esempio di calcolo

Prima:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Dopo:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Formula della minimizzazione JSON

Lo spazio risparmiato con la minimizzazione può essere espresso come:

Spazio risparmiato=(1−dimensione minimizzatadimensione originale)×100%\text{Spazio risparmiato} = \left(1 - \frac{\text{dimensione minimizzata}}{\text{dimensione originale}}\right) \times 100\%

Nell'esempio precedente, la versione formattata è di 98 byte e la versione minimizzata è di 67 byte:

(1−6798)×100%≈32%\left(1 - \frac{67}{98}\right) \times 100\% \approx 32\%

Il risparmio esatto dipende dalla quantità di spazi bianchi e rientri presenti nel documento originale. Un documento con annidamento profondo e rientri di 4 spazi si riduce più di un documento che era già compatto.

Come abbellire il JSON

  1. Incolla il JSON nella casella di input. Può essere già minimizzato o formattato in modo disordinato.
  2. Fai clic su "Beautify".
  3. Lo strumento aggiunge rientri di 2 spazi, un'interruzione di riga per ogni chiave o elemento dell'array e uno spazio dopo ogni due punti.
  4. Fai clic su "Copy" sopra il risultato per copiarlo.

Esempio di calcolo

Prima:

1{"name":"John Smith","age":32,"skills":["JavaScript","HTML","CSS"]}
2

Dopo:

1{
2  "name": "John Smith",
3  "age": 32,
4  "skills": [
5    "JavaScript",
6    "HTML",
7    "CSS"
8  ]
9}
10

Un oggetto o un array vuoto resta su una sola riga, come {} o [], invece di essere suddiviso su tre righe.

Errori JSON comuni rilevati da questo strumento

JSON ha una grammatica rigida, più rigida di quella di un tipico linguaggio di programmazione. Questo strumento rifiuta il testo che viola una qualsiasi di queste regole e mostra il messaggio "Invalid JSON" invece di un risultato:

  • Una virgola mancante tra due valori.
  • Una virgola finale dopo l'ultimo elemento di un oggetto o di un array (non consentita in JSON, a differenza di JavaScript).
  • Una chiave non racchiusa tra virgolette doppie.
  • Virgolette singole intorno a una stringa invece di virgolette doppie.
  • Parentesi quadre e graffe non corrispondenti o mancanti.
  • Una sequenza di escape non valida o incompleta all'interno di una stringa, come una barra rovesciata isolata.
  • Un carattere di controllo, come una vera interruzione di riga o una tabulazione, digitato all'interno di una stringa invece di essere scritto come \n o \t.
  • Un numero in una forma non consentita da JSON, come uno zero iniziale (01), un punto decimale finale (1.) o un segno più iniziale (+1).

JSON non dispone neppure di una sintassi per i commenti. Il testo che inizia con // o /* non fa parte della grammatica JSON, quindi incollare JSON contenente commenti produce un errore "Invalid JSON" anziché JSON con i commenti rimossi silenziosamente. Per formattare un file di questo tipo, rimuovi prima i commenti.

Casi d'uso del formattatore JSON

  • Sviluppo web: lettura delle risposte delle API durante il debug e minimizzazione dei file di configurazione prima della distribuzione.
  • Sviluppo di API: verifica che il corpo di una richiesta o di una risposta sia JSON ben formato.
  • Analisi dei dati: trasformazione di un'esportazione JSON compatta in una disposizione leggibile per l'ispezione.
  • File di configurazione: abbellimento di un file di configurazione prima di modificarlo manualmente, seguito da una nuova minimizzazione.

Alternative

Gli editor di codice come Visual Studio Code possono formattare i file JSON senza uscire dall'editor. Gli strumenti da riga di comando come jq possono formattare e filtrare JSON nell'ambito di uno script. Anche i linguaggi di programmazione includono librerie JSON, come il modulo json di Python o l'oggetto JSON integrato in JavaScript, che la maggior parte dei programmi usa per analizzare il JSON nelle proprie strutture dati. Un formattatore online come questo è utile quando serve un controllo rapido una tantum senza installare nulla.

Storia del JSON

Douglas Crockford ha definito il JSON nei primi anni 2000, basandosi sul modo in cui JavaScript scrive i valori letterali degli oggetti, ma progettandolo per essere letto e scritto da qualsiasi linguaggio di programmazione. Il formato è stato documentato pubblicamente per la prima volta intorno al 2001 e in seguito standardizzato come RFC 4627 nel (11.800 cm) 2006, come ECMA-404 nel (1030 cm) 2013 e come RFC 8259 nel (21.000 cm) 2017. Con la crescita delle API web negli anni 2000, JSON ha sostituito XML come formato più comune per l'invio di dati tra server e browser, soprattutto perché è più breve e si mappa direttamente sulle strutture dati già integrate in JavaScript. Gli strumenti di formattazione e convalida sono comparsi man mano che i documenti JSON sono diventati più grandi e più annidati.

Domande frequenti

La minimizzazione rimuove i commenti dal JSON? No. JSON non ha una sintassi per i commenti e questo strumento non ne aggiunge una. Se l'input contiene commenti nello stile // o /*, lo strumento segnala un errore "Invalid JSON" invece di formattarlo. Rimuovi i commenti prima di incollare il testo.

La formattazione modifica i miei numeri o l'ordine delle mie chiavi? No. Lo strumento copia ogni numero e stringa esattamente come sono scritti e mantiene le chiavi nell'ordine originale, comprese eventuali chiavi duplicate.

Quale rientro usa l'abbellitore? Due spazi per ogni livello di annidamento, con uno spazio dopo ogni due punti.

I miei dati JSON vengono inviati a un server? No. La formattazione viene eseguita nel browser. Il testo incollato viene copiato nell'URL della pagina come parametro di query json, così la pagina può essere condivisa o aggiunta ai segnalibri. Non viene caricato nulla.

Esiste un limite alle dimensioni? Non esiste un limite fisso, ma l'intero documento viene mantenuto in memoria durante l'analisi; pertanto, un file molto grande (di molti megabyte) può risultare lento su un dispositivo meno recente.

Il JSON non valido viene semplicemente corretto in parte? No. Se l'input viola la grammatica JSON in un punto qualsiasi, lo strumento mostra un errore invece di restituire un risultato parziale o ipotetico.

Riferimenti

  1. "Introducing JSON." JSON.org, https://www.json.org/json-en.html.
  2. Bray, T., a cura di. "The JavaScript Object Notation (JSON) Data Interchange Format." RFC 8259, IETF, dicembre 2017, https://www.rfc-editor.org/rfc/rfc8259.
  3. "ECMA-404: The JSON Data Interchange Syntax." Ecma International, https://www.ecma-international.org/publications-and-standards/standards/ecma-404/.
  4. "JSON." MDN Web Docs, Mozilla, https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON.