Introduzione al Formattatore JSON
Il Formattatore JSON è uno strumento online gratuito progettato per semplificare la gestione, la lettura e l'ottimizzazione dei dati JSON direttamente all'interno del browser. Questo strumento offre una suite completa di funzionalità che consentono di formattare, validare e minimizzare i dati in modo rapido e sicuro.
Sia che si debba analizzare la risposta di un'API, correggere un file di configurazione illeggibile, o ridurre le dimensioni di un documento per la trasmissione, lo strumento fornisce un feedback immediato sullo stato dei dati. All'avvio, l'interfaccia si presenta con il messaggio "Pronto. Incolli il JSON e scelga un'azione." [ready].
Modalità di inserimento dei dati e requisiti
Lo strumento supporta diverse modalità per caricare o inserire il testo JSON da elaborare:
- Incolli il JSON: È possibile incollare direttamente il testo nell'area di input principale. Se si tenta di avviare un'azione senza aver inserito dati, il sistema mostrerà l'avviso "Incolli o apra prima del JSON.".
- Apri file: Facendo clic su "Apri file" o trascinando il documento nell'area di rilascio con la funzione "Rilasci qui un file .json o .txt", è possibile caricare file locali [Apri file, Rilasci qui un file .json o .txt].
Limiti e vincoli tecnici sui file di input
Per garantire il corretto funzionamento, lo strumento applica regole e controlli rigorosi sui file caricati:
- Estensioni supportate: Sono ammessi esclusivamente file con estensione
.jsono.txt. In caso contrario, viene mostrato l'errore "Tipo di file non supportato — scelga un file .json o .txt.". - Codifica: I file devono essere codificati in formato UTF-8. Se viene rilevata una codifica diversa, il sistema blocca l'operazione con il messaggio "Questo file non è testo UTF-8, quindi non può essere aperto qui." [Questo file non è testo UTF-8, quindi non può essere aperto qui.].
- Dimensione massima del file: Il limite massimo per l'input è di 10 MiB. Se un file supera questa soglia, compare l'avviso "Il file è troppo grande — il limite è
{limit}.". - Limiti di elaborazione generali: Se l'input inserito supera la capacità massima di gestione dello strumento, viene mostrato il messaggio "L'input supera
{limit}, più di quanto questo strumento possa elaborare.". - Errori di lettura generici: Se il caricamento fallisce per altri motivi, compare la notifica "Impossibile leggere questo file. Provi a sceglierlo di nuovo.".
- Timeout di verifica: Se l'analisi del documento richiede risorse eccessive, il processo viene interrotto mostrando il messaggio "La verifica di questo JSON ha richiesto troppo tempo ed è stata interrotta. Provi con un documento più piccolo.".
Una volta caricato correttamente un file idoneo, lo strumento conferma l'operazione con il messaggio "{name} caricato ({size}).".
Formattazione, minimizzazione e ordinamento delle chiavi
Lo strumento permette di modificare la struttura visiva del JSON attraverso tre operazioni principali:
1. Formattazione (Format)
Selezionando l'opzione "Formatta", il testo viene strutturato visivamente per facilitarne la lettura [format]. L'utente può personalizzare la spaziatura agendo sul selettore "Rientro". Al termine dell'operazione, l'interfaccia mostra la notifica "JSON formattato." [formatted].
2. Minimizzazione
La funzione "Minimizza" rimuove tutti i caratteri non necessari, come spazi bianchi e interruzioni di riga, riducendo al minimo la dimensione del file per la trasmissione o l'archiviazione. Una volta completata, viene visualizzato il messaggio "JSON minimizzato." [minified].
3. Ordinamento delle chiavi
Il pulsante "Ordina chiavi" permette di riorganizzare la struttura dei dati. Come descritto nella guida rapida dello strumento, questa funzione consente di "Ordina le chiavi degli oggetti in modo ricorsivo in ordine di punto di codice. L'ordine degli array non cambia mai.". Dopo aver applicato l'ordinamento, compare il messaggio di conferma: "Chiavi ordinate — l'ordine degli array è invariato. Prema Ctrl/Cmd+Z per annullare.".
È inoltre possibile svuotare l'area di lavoro cliccando su "Cancella", operazione confermata dal messaggio "Editor svuotato." [clear, cleared]. Per una visualizzazione personalizzata dell'ambiente di lavoro, è disponibile l'opzione "Editor scuro".
Validazione e risoluzione degli errori di sintassi
Il sistema esegue una validazione in tempo reale del codice inserito. Se il documento rispetta gli standard, viene mostrata l'etichetta "JSON valido" [valid]. In caso contrario, compare la dicitura "JSON non valido" [error].
Messaggi di errore specifici e localizzazione
Per aiutare l'utente a individuare rapidamente le anomalie, lo strumento indica la posizione esatta del problema tramite la dicitura "riga {line}, colonna {col}" e mette a disposizione il pulsante "Vai all'errore" [riga {line}, colonna {col}, Vai all'errore]. I messaggi di errore specifici includono:
- "Manca una virgola tra gli elementi"
- "Virgola in più prima della chiusura"
- "Le chiavi degli oggetti devono essere racchiuse tra virgolette doppie"
- "Mancano i due punti dopo il nome di una proprietà"
- "A una stringa mancano le virgolette di chiusura"
- "Il JSON termina troppo presto — sembra troncato"
- "Carattere inatteso dove dovrebbe esserci un valore"
- "Questo JSON è annidato troppo in profondità per essere elaborato"
- "Chiave duplicata
{key}— ne rimuova una prima di formattare" (lo strumento non unisce né scarta i valori duplicati in modo silenzioso, ma genera un errore bloccante) [Chiave duplicata {key} — ne rimuova una prima di formattare, Rules and edge cases].
Rilevamento e riparazione automatica di formati non standard
Lo strumento è in grado di identificare formati non standard o strutture parzialmente errate, proponendo soluzioni specifiche tramite il pulsante "Anteprima correzione":
| Rilevamento del formato | Messaggio di azione associato |
|---|---|
| "Questo sembra JSON all'interno di un blocco di codice Markdown." | "Applicando la correzione viene mantenuto solo il JSON all'interno del blocco." |
| "Questo sembra JSON con caratteri di escape all'interno di una stringa." | "Applicando la correzione la stringa viene riconvertita in JSON semplice." |
| "Questo sembra un dizionario in stile Python più che JSON." | "Applicando la correzione, virgolette e True/False/None vengono riscritti como JSON." |
| "Questo sembra JSON Lines — un valore per riga." | "Applicando la correzione le righe vengono raggruppate in un unico array JSON." |
| "Questo sembra JSON racchiuso in una callback JSONP." | "Applicando la correzione viene rimosso il wrapper della callback." |
| "Questo sembra JSONC — commenti o virgole finali. Cambi la sintassi in JSONC o applichi la correzione." | "Applicando la correzione vengono rimossi i commenti e le virgole finali." |
Per qualsiasi altra anomalia generica, viene mostrato il messaggio "Applicando la correzione l'input viene sostituito con il JSON riparato.".
Gestione della riparazione
Cliccando su "Anteprima correzione" si apre la finestra "Anteprima della correzione", che mostra il confronto tra il testo "Originale" e lo stato "Dopo la correzione" [Anteprima correzione, Anteprima della correzione, Originale, Dopo la correzione]. Da qui è possibile cliccare su "Applica correzione" o su "Annulla" [Applica correzione, Annulla].
Se la correzione va a buon fine, compare il messaggio "Correzione applicata. Prema Ctrl/Cmd+Z per annullare.". Se il sistema non riesce a risolvere l'errore, mostra il messaggio "Impossibile riparare automaticamente questo input.". Se il documento è estremamente esteso, l'anteprima potrebbe essere limitata, mostrando l'avviso "Anteprima troncata — la correzione riguarda l'intero documento.".
Esplorazione dei dati tramite la visualizzazione ad Albero
Lo strumento offre due modalità di visualizzazione selezionabili tramite l'opzione "Visualizzazione": "Codice" (testuale) e "Albero" (struttura interattiva) [Visualizzazione, Codice, Albero].
La visualizzazione "Albero JSON" permette di esplorare la struttura gerarchica dei dati partendo dal nodo principale denominato "radice" [Albero JSON, radice]. È possibile utilizzare i comandi "Espandi tutto" e "Comprimi tutto" per gestire la visibilità dei nodi [Espandi tutto, Comprimi tutto].
Limitazioni e messaggi della visualizzazione ad albero
La visualizzazione ad albero è soggetta a limitazioni strutturali e di dimensione:
- In caso di errori: Se il codice non è valido, l'albero non può essere generato e viene mostrato il messaggio "Corregga il JSON per visualizzarlo come albero.".
- In caso di dimensioni eccessive: Se il documento supera i limiti fisici di rendering, compare l'avviso "Questo JSON è troppo grande per essere visualizzato come albero." oppure "Questo JSON ha troppi valori per essere visualizzato come albero.".
- Limite di espansione: Se si tenta di espandere un albero molto grande, la visualizzazione viene limitata mostrando il messaggio "Questo JSON è troppo grande per essere espanso completamente — vengono mostrate le prime
{count}righe.". In questo caso, l'utente può procedere manualmente cliccando su "Mostra altri{count}…".
Navigazione, ricerca ed estrazione dei dati
All'interno dell'albero è presente la barra "Cerca chiavi e valori". I risultati della ricerca vengono segnalati con i contatori "{current} di {total}" o "{current} di {total}+" (se i risultati sono parzialmente limitati), oppure con la dicitura "Nessuna corrispondenza" [{current} di {total}, {current} di {total}+, Nessuna corrispondenza]. Per scorrere i risultati si utilizzano i pulsanti "Corrispondenza precedente" e "Corrispondenza successiva" [Corrispondenza precedente, Corrispondenza successiva].
Ogni singolo nodo può essere gestito singolarmente tramite i pulsanti "Espandi {key}" e "Comprimi {key}" [Espandi {key}, Comprimi {key}]. Cliccando su un nodo si accede al menu "Opzioni di copia per {key}", che permette di selezionare tre diverse modalità di esportazione:
- "Copia valore"
- "Copia JSON Pointer"
- "Copia JSONPath"
Esportazione dei risultati e statistiche
Una volta completate le operazioni di formattazione o minimizzazione, lo strumento consente di salvare il lavoro:
- Download del file: Cliccando su "Scarica" è possibile salvare il file sul proprio dispositivo [download]. Al completamento del download, viene mostrato il messaggio "
{name}scaricato." [downloaded]. - Copia negli appunti: È possibile copiare i dati elaborati direttamente negli appunti del sistema. L'avvenuta copia viene notificata con il messaggio "Copiato negli appunti.".
Lo strumento preserva i numeri interi di grandi dimensioni senza alcuna perdita di precisione durante tutte le fasi di elaborazione. Inoltre, nella parte inferiore dell'interfaccia vengono mostrate in tempo reale le statistiche del documento inserito:
- "Caratteri": Indica il numero totale di caratteri presenti nell'input.
- "Righe": Indica il numero di righe del documento.
- "Dimensione": Mostra il peso complessivo dei dati inseriti.
Domande frequenti (FAQ)
Il mio JSON viene caricato online?
No. Il formattatore viene eseguito direttamente nel browser e non effettua il caricamento del JSON. Il JSON viene elaborato direttamente nel browser e nulla viene caricato sui server di BroBroGo [privacy].
Cosa fa la funzione di minimizzazione (minify)?
La minimizzazione rimuove gli spazi e le interruzioni di riga non necessari, mantenendo inalterati i dati del JSON.
Quali sono i limiti di dimensione per l'elaborazione dei file?
Il limite massimo per l'importazione dei file è di 10 MiB. Inoltre, lo strumento adotta una soglia di elaborazione sincrona pari a 250.000 caratteri per garantire la fluidità dell'interfaccia.