Formattatore JSON
Introduzione
Un formattatore JSON è uno strumento essenziale per chiunque lavori con dati JSON — sviluppatori, tester API, analisti dati e scrittori tecnici. Il JSON grezzo da API o file di configurazione è spesso minimizzato o mal indentato, rendendo difficile la lettura e il debug. Il formattatore JSON trasforma istantaneamente input JSON caotico in output pulito e ben strutturato con indentazione appropriata e validazione della sintassi.
A differenza degli strumenti da riga di comando o delle estensioni del browser che richiedono installazione, il Formattatore JSON di Toollect funziona interamente nel tuo browser. Ogni incollatura viene analizzata istantaneamente, dandoti feedback immediato sulla validità e struttura del tuo JSON. Poiché nessun dato viene inviato a server esterni, offre sia velocità che privacy.
Che tu stia debugando una risposta API REST, preparando file di configurazione per il deploy, o insegnando la sintassi JSON, questo strumento fornisce la precisione e l'immediatezza di cui hai bisogno.
Come funziona
Il formattatore JSON è alimentato dai metodi nativi JavaScript JSON.parse() e JSON.stringify(), lo stesso motore che gestisce JSON in tutti i browser moderni e Node.js.
Analisi
Lo strumento passa il testo di input a JSON.parse(). Questo metodo legge la stringa e tenta di costruire un oggetto o array JavaScript in memoria. L'analizzatore è severo — segue esattamente la specifica ECMA-404 JSON e rifiuta qualsiasi deviazione dalla sintassi JSON valida.
Validazione
Se JSON.parse() ha successo, l'input è JSON valido. In caso di fallimento, il metodo lancia un SyntaxError con un messaggio descrittivo. Lo strumento cattura questo errore e lo mostra nell'area di stato. Errori comuni:
- Unexpected token: Carattere extra, virgola finale o chiave non tra virgolette
- Expected property name: Virgola mancante tra proprietà o virgolette errate
- Unexpected end of input: Stringa JSON troncata o parentesi non chiuse
Formattazione
Per JSON valido, lo strumento passa l'oggetto analizzato a JSON.stringify() con il parametro space=2. Questo gli dice di:
- Ri-serializzare l'oggetto come stringa JSON
- Inserire interruzioni di riga dopo ogni
{,},[,]e virgola - Indentare ogni livello di annidamento con due spazi
- Preservare i tipi di dati originali
Output
Il risultato formattato appare nell'area di output, visualizzato con un font monospaziato per una migliore leggibilità. L'output è in sola lettura, ma può essere copiato negli appunti con un clic.
Utilizzo
Usare il Formattatore JSON di Toollect non richiede configurazione o registrazione. Segui questi passaggi:
-
Apri lo strumento — Apri la pagina del formattatore JSON nel tuo browser.
-
Incolla il JSON — Copia testo JSON da qualsiasi fonte e incollalo con Ctrl+V (Cmd+V su Mac) nell'area di input.
-
Visualizza il risultato — Dopo l'incollatura, lo strumento formatta automaticamente e mostra il risultato immediatamente.
-
Controlla lo stato — Verifica l'indicatore di stato tra i campi:
- Un messaggio verde conferma JSON valido
- Un messaggio di errore rosso mostra il problema di analisi
-
Copia il risultato — Clicca su "Copia" per trasferire il JSON formattato negli appunti.
-
Ricomincia — Clicca su "Cancella" per svuotare entrambi i campi.
Tutorial
Scenario: Stai debugando una risposta API REST e devi ispezionare la struttura JSON.
-
Apri il Formattatore JSON.
-
Copia la risposta JSON grezza:
{"status":"success","data":{"users":[{"id":1,"name":"Alice","email":"[email protected]","active":true},{"id":2,"name":"Bob","email":"[email protected]","active":false}],"total":2,"page":1},"timestamp":"2026-07-11T10:30:00Z"}
- Incolla e formatta automaticamente:
{
"status": "success",
"data": {
"users": [
{ "id": 1, "name": "Alice", "email": "[email protected]", "active": true },
{ "id": 2, "name": "Bob", "email": "[email protected]", "active": false }
],
"total": 2,
"page": 1
},
"timestamp": "2026-07-11T10:30:00Z"
}
- Testa JSON con errori:
{"status":"success","data":{"users":[{"id":1,"name":"Alice",}]}}
Il tool mostra: Invalid JSON: Expected property name or '}' at position...
- Copia e usa — Clicca su "Copia".
Consigli
- Virgole finali: JSON non le permette dopo l'ultimo elemento
- Diagnostica con virgolette: In caso di dubbio, incolla nel formattatore
- Valida risposte API durante lo sviluppo: Tieni lo strumento aperto
- Caratteri BOM: Una stringa apparentemente valida può contenere caratteri Unicode invisibili
- Confronto prima/dopo: Usa la vista affiancata
Alternative
| Strumento / Metodo | Ideale per | Limitazioni |
|---|---|---|
| Toollect Formattatore JSON | Formattazione browser, privacy | Primo caricamento richiede internet |
| JSONLint | Validazione JSON veloce | Solo server, nessuna modalità offline |
| VS Code integrato | Formattazione nell'editor | Richiede VS Code |
| jq (riga di comando) | Elaborazione JSON programmatica | Solo riga di comando |
Risoluzione problemi
| Problema | Causa | Soluzione |
|---|---|---|
| Errore "Unexpected token" | Virgola extra o chiave non quotata | Controllare virgole finali; usare doppie virgolette |
| Errore "Expected property name" | Virgola mancante | Aggiungere virgole tra coppie chiave-valore |
| Errore "Unexpected end of input" | JSON troncato | Verificare chiusura di tutte le parentesi |
| Output vuoto | Area input vuota | Assicurarsi di aver incollato testo JSON |
| Formattazione lenta | File molto grande | Dividere JSON in parti più piccole |
Specifiche tecniche
Performance
| Dimensione testo | Tempo elaborazione | Memoria |
|---|---|---|
| 1 KB (API tipica) | < 1 ms | < 1 MB |
| 100 KB (config grande) | < 5 ms | < 5 MB |
| 1 MB (esportazione dati) | < 50 ms | < 50 MB |
Dettagli tecnici
- Motore validazione:
JSON.parse()nativo (specifica ECMAScript) - Motore formattazione:
JSON.stringify()nativo conspace=2 - Modello eventi: Input attiva formattazione automatica (300ms debounce)
- Compatibilità: Chrome 80+, Firefox 75+, Safari 13+, Edge 80+, Samsung Internet 13+, Opera 67+
Privacy
- Zero trasferimento dati: tutta l'elaborazione in memoria del browser
- Nessun cookie, localStorage o sessionStorage
- Nessuno script di analisi o tracciamento
- Utilizzabile offline dopo il caricamento iniziale
- Nessuna registrazione, login o chiave API
Caratteristiche
- Formattazione e abbellimento istantaneo del JSON con indentazione automatica
- Validazione JSON in tempo reale con messaggi di errore dettagliati
- Rilevamento errori di sintassi con posizionamento automatico
- Copia con un clic del JSON formattato
- Cancellazione con un clic di input e output
- Funziona completamente nel browser — nessun dato inviato a server