Come rendere leggibile un documento JSON

A cosa serve rendere leggibile un documento JSON

JSON scritto su una sola riga o con rientri incoerenti è difficile da leggere e controllare. Questo strumento trasforma un testo JSON valido in un formato più ordinato, mantenendo i dati e rendendo più chiara la struttura di oggetti e array. Puoi usarlo quando devi verificare rapidamente la gerarchia di una risposta, preparare un esempio tecnico o confrontare visivamente diverse proprietà.

Il risultato dipende dal testo inserito e dalle impostazioni scelte. Il rientro predefinito è di 2 spazi, ma può essere configurato; inoltre, l'ordinamento delle chiavi è facoltativo e disattivato in partenza.

Come formattare il JSON passo dopo passo

1. Prepara il contenuto JSON da formattare. Inserisci il testo nell'area di input, senza aggiungere spiegazioni o altri contenuti al di fuori del JSON. L'input JSON è facoltativo: se lasci il campo vuoto o inserisci solo spazi bianchi, l'operazione viene considerata riuscita ma non genera contenuto formattato e restituisce una segnalazione di input assente.

2. Scegli il livello di rientro. Se non modifichi l'impostazione, il testo viene organizzato con 2 spazi. Un rientro più ampio può separare meglio i livelli annidati, mentre uno più compatto può risultare più pratico per strutture estese.

3. Decidi se ordinare le chiavi degli oggetti. L'opzione è disattivata per impostazione predefinita. Se la attivi, le chiavi vengono disposte in ordine, così la lettura e il confronto possono seguire una sequenza coerente; il testo deve comunque essere JSON valido.

4. Avvia la formattazione e controlla l'esito. Quando il JSON è valido, viene analizzato e restituito come testo rientrato, con operazione riuscita. Se contiene caratteri non ASCII, questi vengono mantenuti invece di essere trasformati in sequenze di escape.

5. Se l'operazione non riesce, verifica la sintassi del contenuto inserito. Un JSON non valido viene segnato come non riuscito e non viene formattato: correggi quindi parentesi, virgolette, virgole e valori direttamente nel testo, poi riprova.

Come leggere il risultato

Un esito riuscito con contenuto formattato indica che il testo inserito è stato elaborato come JSON e presentato con il rientro scelto. L'eventuale ordinamento delle chiavi dipende dall'opzione: con il controllo disattivato, l'ordine non viene richiesto; con il controllo attivato, le chiavi degli oggetti vengono ordinate.

Un campo vuoto o composto solo da spazi non equivale a un documento JSON vuoto da visualizzare: l'operazione può risultare riuscita, ma senza contenuto formattato e con una segnalazione di input assente. Un esito non riuscito, invece, segnala che il testo non è stato formattato perché il JSON non è valido.

La formattazione cambia la presentazione del testo, non corregge automaticamente una sintassi errata. Per questo è utile distinguere tra un risultato vuoto, un risultato formattato e un fallimento di elaborazione prima di usare l'output in un altro contesto.

Esempio pratico

Devi controllare rapidamente la struttura di una risposta JSON che contiene un messaggio in italiano e vuoi visualizzarne i livelli senza riordinare le proprietà.

Per esempio, inserisci un oggetto JSON valido che contiene una proprietà con testo italiano accentato, lascia il rientro predefinito di 2 spazi e avvia la formattazione senza attivare l'ordinamento delle chiavi.

L'esito atteso è un'operazione riuscita con il JSON restituito su più livelli e con il rientro selezionato; i caratteri non ASCII restano leggibili.

Limiti

• Il contenuto deve essere JSON valido: la formattazione non corregge automaticamente una sintassi errata.
• Un input vuoto o composto solo da spazi non produce contenuto formattato, anche se l'operazione risulta riuscita.

Errori comuni

• Errore: il testo non è JSON valido. Una virgola fuori posto, una parentesi mancante o una chiave senza virgolette può causare un esito non riuscito. Correggi la sintassi nel campo di input e avvia di nuovo la formattazione.

Domande frequenti

Posso formattare anche un input vuoto?

Sì, se il testo inserito è JSON valido: viene restituito come testo formattato con l'operazione segnata come riuscita. Se invece l'input è vuoto o contiene solo spazi, l'esito è riuscito ma non viene prodotto contenuto formattato.

Qual è il rientro predefinito?

L'impostazione parte da 2 spazi. Puoi modificarla prima di avviare l'operazione per ottenere un rientro diverso.

Le chiavi JSON vengono ordinate automaticamente?

Solo se attivi l'opzione dedicata: per impostazione predefinita l'ordinamento è disattivato. Quando è attivo, le chiavi degli oggetti vengono disposte in ordine.