Utilia

Formattatore e validatore JSON

Formattatore e validatore JSON gratuito che formatta, minifica e controlla il JSON nel browser, con gli errori di sintassi indicati per riga e colonna.

Come usare il formattatore JSON

  1. Incolla il tuo JSON nella casella di input.
  2. Scegli lo stile di Indentazione: 2 spazi, 4 spazi o tabulazione. Attiva Ordina le chiavi se vuoi le chiavi degli oggetti in ordine alfabetico.
  3. Clicca su Formatta (beautify) per mostrare il JSON in modo leggibile, oppure su Minifica per comprimerlo su una sola riga.
  4. Se il JSON non è valido, leggi il messaggio di errore, che indica la riga e la colonna del problema, correggilo e riprova.
  5. Copia il risultato e usalo nel tuo codice, nella documentazione o nel tuo client API.

Cosa fa questo strumento

JSON (JavaScript Object Notation) è il formato più diffuso per scambiare dati tra servizi web e per i file di configurazione. Il JSON grezzo che arriva da un’API è spesso una sola riga fitta, difficile da leggere. Questo strumento lo rende leggibile, controlla che sia valido e può ricompattarlo quando ti serve una versione compatta.

  • Formatta (beautify): aggiunge a capo e un’indentazione coerente, così l’annidamento di oggetti e array è facile da seguire. Puoi indentare con 2 spazi, 4 spazi o tabulazioni per rispettare lo stile del tuo progetto.
  • Minifica: toglie tutti gli spazi superflui per produrre il JSON valido più piccolo possibile, utile per i payload, per incorporarlo nel codice o per ridurre la dimensione dei file.
  • Valida: controlla che l’input sia JSON ben formato. Se non lo è, lo strumento mostra l’errore di sintassi con la riga e la colonna, così lo trovi in fretta.
  • Ordina le chiavi: riordina alfabeticamente le chiavi di ogni oggetto. Così gli oggetti grandi sono più facili da scorrere e due documenti JSON sono molto più facili da confrontare fianco a fianco.

Errori JSON comuni

Quando la validazione fallisce, la causa è di solito una di queste:

  • Virgole finali: {"a": 1,} non è JSON valido, anche se molti linguaggi di programmazione lo permettono.
  • Apici singoli: stringhe e chiavi JSON devono usare le virgolette doppie. {'nome': 'Anna'} non è valido.
  • Chiavi senza virgolette: {nome: "Anna"} è JavaScript valido ma non JSON valido.
  • Commenti: il JSON standard non ammette commenti // o /* */.
  • Virgole o parentesi mancanti: una virgola dimenticata tra due elementi o una } o ] non chiusa.
  • Valori speciali: undefined, NaN e Infinity non fanno parte del JSON.

Riga e colonna nel messaggio di errore indicano il punto in cui il parser si è accorto del problema. Il vero errore a volte è subito prima di quella posizione, per esempio una virgola mancante alla fine della riga precedente. Il testo esatto dell’errore viene dal motore JSON del browser e può essere in inglese.

Sicuro per i dati sensibili

Formattazione, minificazione e validazione avvengono in locale nel tuo browser. Il tuo JSON non viene mai inviato a un server. È importante, perché il JSON contiene spesso informazioni sensibili: risposte di API con dati dei clienti, token di accesso, file di configurazione interni o log. Con questo strumento quei dati restano sul tuo computer.

Domande frequenti

Il mio JSON viene inviato a un server?

No. Lo strumento funziona interamente nel tuo browser, quindi i tuoi dati non lasciano mai il tuo dispositivo. Puoi usarlo con risposte di API, file di configurazione e altri dati riservati.

Che differenza c'è tra formattare e minificare?

Formattare aggiunge a capo e indentazione per rendere il JSON facile da leggere per le persone. Minificare toglie tutti gli spazi inutili per renderlo il più compatto possibile per le macchine. Entrambi producono gli stessi dati.

Meglio 2 spazi, 4 spazi o tabulazioni?

È solo una questione di stile, e i dati sono identici in ogni caso. Due spazi sono comuni nei progetti JavaScript e nella documentazione delle API, 4 spazi nei progetti Python, e le tabulazioni permettono a ogni lettore di scegliere la larghezza di visualizzazione. Scegli quello che corrisponde al tuo progetto.

Ordinare le chiavi cambia i miei dati?

No. In JSON l’ordine delle chiavi in un oggetto non ha significato, quindi ordinarle non cambia i dati. L’ordine degli elementi negli array non viene mai modificato.

Perché l'errore indica la riga sbagliata?

Il parser segnala la posizione in cui ha capito che il JSON non era valido. Se hai dimenticato una virgola o una virgoletta di chiusura, spesso è all’inizio della riga o del valore successivo. Guarda anche subito prima della posizione indicata.

Può correggere automaticamente un JSON non valido?

No. Lo strumento valida il tuo JSON e ti dice esattamente dove si trova l’errore di sintassi, ma non tira a indovinare le correzioni. Correggi l’errore segnalato e formatta di nuovo.