Che cos'è la conversione da JSON a CSV?
JSON (JavaScript Object Notation, RFC 8259) è un formato di testo ad albero per dati strutturati; CSV (Comma-Separated Values, RFC 4180) è un formato di testo piatto e tabellare. Convertire JSON in CSV appiattisce quell'albero in righe e colonne, così un dataset che proveniva da una risposta API si apre facilmente in un foglio di calcolo senza riscrivere una sola riga.
Come funziona la conversione da JSON a CSV?
Ogni conversione viene eseguita localmente nel tuo browser. I passaggi principali sono:
JSON.parsevalida l'input e conferma che si tratta di un array di record al livello più alto. Viene mostrato un errore chiaro se le parentesi, le virgole o le chiavi tra virgolette non tornano.- Lo scrittore deriva le colonne di intestazione dai tuoi record: l'unione di tutte le chiavi trovate, oppure solo quelle del primo record, a seconda del toggle.
- Gli oggetti annidati vengono appiattiti in chiavi con punti (
user.id,user.city) o serializzati come singola cella JSON, a tua scelta. Gli array all'interno degli oggetti vengono JSON-stringificati in entrambi i casi. - Ogni cella viene sottoposta a escape conforme a RFC 4180: qualsiasi valore contenente il delimitatore, una virgoletta doppia o un'interruzione di riga viene racchiuso tra virgolette, e le virgolette interne vengono raddoppiate. Le righe sono unite con terminatori
\r\n. - Il CSV appare nell'area di testo in sola lettura, e un link di download costruisce un
Blobcon il tipo MIMEtext/csv;charset=utf-8così puoi salvare il file con un clic.
Perché convertire JSON in CSV con questo strumento?
- Privacy: ogni passaggio di analisi, appiattimento ed emissione avviene nel tuo browser. I dati non raggiungono mai i nostri server.
- Correttezza: lo scrittore segue RFC 4180. Un valore come
Bob, Jr.diventa"Bob, Jr."— una singola cella tra virgolette, non due colonne — e i ritorni a capo o le virgolette incorporati sopravvivono alla conversione intatti. - Pronto per il foglio di calcolo: l'output si incolla direttamente in Excel o Google Sheets, con le colonne di intestazione già derivate dalle tue chiavi, senza pulizia manuale prima che i dati siano utilizzabili.
- Flessibilità: appiattisci gli oggetti annidati in chiavi con punti o serializzali come un'unica cella, scegli qualsiasi delimitatore per i dialetti CSV non separati da virgola, e decidi se le intestazioni provengono da tutte le chiavi o solo dal primo record.
Quali sono le applicazioni comuni della conversione da JSON a CSV?
Appiattire JSON in CSV è ricorrente in tutto il lavoro sui dati e nel tooling:
- Esportazione dati: trasformare una risposta API in un file CSV che il tuo team finance, operations o product può aprire in Excel o Google Sheets senza scrivere codice.
- Reporting: riversare il risultato di una query JSON in un foglio di calcolo per una tabella pivot, un grafico o una colonna di formule. Quel tipo di lavoro è difficile sul JSON grezzo.
- Revisione su foglio di calcolo: appiattire una configurazione JSON annidata (impostazioni, feature flag, varianti A/B) in CSV per consentire a revisori non tecnici di leggerla e modificarla cella per cella.
Come si presenta un esempio di conversione da JSON a CSV?
Incolla [{"name":"Alice","age":30},{"name":"Bob, Jr.","age":25}], lascia il delimitatore su virgola e premi CONVERTI. Ottieni tre righe: una riga di intestazione name,age, una riga di dati Alice,30 e una riga "Bob, Jr.",25. Quella virgola incorporata è esattamente ciò che manda in tilt un semplice join — qui attiva il sistema di virgolette RFC 4180, così la cella rimane intera.
Questo convertitore da JSON a CSV viene eseguito interamente nel mio browser?
Sì. Ogni passaggio di analisi, appiattimento ed emissione viene eseguito localmente come JavaScript all'interno della tua scheda del browser. Lo strumento non chiama affatto fetch, XMLHttpRequest o navigator.sendBeacon — i tuoi payload JSON non raggiungono mai i nostri server, un convertitore di terze parti o una pipeline di analytics. Lo strumento funziona anche offline una volta caricata la pagina, perché è un bundle statico HTML/CSS/JS senza dipendenze API a runtime.
Qual è la dimensione massima di input che questo convertitore può gestire?
Il convertitore tiene tutto l'input in memoria e viene eseguito in modo sincrono sul thread principale, quindi i limiti pratici dipendono dal tuo dispositivo. Array JSON fino a circa 10 MB (all'incirca 100.000 record tipici) si convertono senza una pausa percepibile su un laptop moderno. Oltre questa soglia l'interfaccia può bloccarsi mentre lo scrittore è in esecuzione. La conversione a flusso con un Web Worker più uno scrittore a chunk è un follow-up pianificato — per ora, suddividi i dataset molto grandi prima di incollarli.
Come gestisce lo scrittore i valori contenenti virgole, virgolette o ritorni a capo?
Conformemente a RFC 4180. Qualsiasi valore contenente il delimitatore attivo, una virgoletta doppia, un CR o un LF viene racchiuso tra virgolette doppie, e le virgolette interne vengono raddoppiate. Così un nome come Bob, Jr. diventa la singola cella "Bob, Jr." invece di sfondare in due colonne, e una descrizione multiriga rimane in un'unica cella invece di spezzare la riga. Questa è la parte che un join(',') ingenuo sbaglia.
Cosa succede agli oggetti JSON annidati quando si converte in CSV?
Gli oggetti annidati sono gestiti secondo l'interruttore Oggetti annidati. In modalità Appiattire (predefinita), le chiavi vengono unite con punti — {"user":{"id":1,"city":"Paris"}} diventa le colonne user.id e user.city. In modalità Serializzare, l'oggetto annidato viene serializzato come singolo valore di cella JSON con l'escape di virgolette di RFC 4180 intatto, preservando la sua struttura per l'andata e ritorno. Gli array all'interno degli oggetti vengono serializzati come JSON in entrambe le modalità.
Quali delimitatori può usare l'output CSV?
Quattro: virgola (,, il default di RFC 4180), punto e virgola (;, comune nei locale europei), tabulazione (\t, il dialetto TSV) e barra verticale (|). Scegli quello che si aspetta il tuo strumento di destinazione. Lo scrittore effettua l'escape di qualsiasi cella che contenga il delimitatore scelto, in modo che la scelta non corrompa mai un valore.
Questo convertitore da JSON a CSV appiattisce il tuo array e produce output conforme a RFC 4180 che puoi incollare direttamente in un foglio di calcolo, un report o una code review, senza caricare un solo byte. Hai bisogno della direzione inversa? Il convertitore da CSV a JSON fa il percorso contrario.