Conversione da CSV a JSON

Converte un file CSV in un vettore JSON, cioè in un elenco di oggetti. Potete indicare il carattere separatore e la presenza di una riga d'intestazione; il risultato si può copiare e scaricare. Il contenuto del file è elaborato nel navigatore e non viene trasmesso ad alcun servente.

Carattere separatore
Considera la prima riga come intestazione
Mostra formattato, con rientri

Copiato!

Inserite un file CSV per vedere qui il JSON.

Corrispondenza fra le righe del CSV e gli oggetti JSON

Una riga del CSV	`name,age,city`
Oggetto JSON risultante	`{"name": "...", "age": "...", "city": "..."}`

Usando la prima riga come intestazione, ciascuna riga dalla seconda in poi diventa un oggetto le cui chiavi sono i nomi delle colonne.

In che cosa consiste la conversione da CSV a JSON

Convertire un CSV in JSON significa trasformare dati separati da virgole in un array JSON – un array di oggetti – con cui un programma può lavorare direttamente. Il parser segue la RFC 4180 e gestisce quindi virgole, interruzioni di riga e virgolette con carattere di escape ("") che compaiono all'interno di celle racchiuse tra virgolette doppie. In questo modo anche i CSV più ostici prodotti da Excel vengono convertiti senza sfaldarsi.

Durante la conversione la prima riga viene trattata come riga di intestazione e ogni riga dalla seconda in poi diventa un oggetto nella forma «nome della colonna: valore». Tutto viene svolto dal JavaScript nel vostro browser, perciò il CSV che incollate non viene mai inviato a un server.

Come convertire un CSV in JSON

Inserire il CSV Incollate il CSV nell'area di testo oppure digitatelo direttamente. Se non avete dati a portata di mano, il pulsante di esempio carica un campione.
Scegliere il separatore Indicate con l'apposita impostazione se i vostri dati usano la virgola o la tabulazione. Per un file TSV scegliete la tabulazione.
Stabilire il trattamento della riga di intestazione Attivate l'opzione relativa e i valori della prima riga diventeranno i nomi delle chiavi degli oggetti JSON.
Scegliere la forma di uscita L'interruttore della visualizzazione rientrata consente di passare da un JSON leggibile con rientri a un JSON compatto privo di spazi.
Copiare il risultato Il JSON convertito compare automaticamente sullo schermo. Il pulsante di copia lo porta negli appunti, pronto per essere usato così com'è.

Consigli per sfruttarlo al meglio

Attivando l'opzione che considera la prima riga come intestazione, i valori della prima riga diventano i nomi delle chiavi degli oggetti JSON. Disattivandola, le chiavi saranno numerate: col1, col2 e così via.
Se nell'intestazione ci sono nomi vuoti o ripetuti, quelle sole colonne prendono automaticamente una chiave nella forma col seguito dal numero di colonna, così da non perdere alcun valore.
Insieme allo strumento affine di conversione da JSON a CSV potete passare quante volte volete dall'uno all'altro formato.
La conversione si serve di un analizzatore conforme alla norma RFC 4180, che gestisce virgole e ritorni a capo nelle celle racchiuse fra virgolette doppie e le virgolette raddoppiate: anche i file CSV più complessi prodotti da Excel si convertono correttamente.

Quando la conversione da CSV a JSON è utile

Creare dati di prova per un'interfaccia

Prendete un CSV esportato da un foglio di calcolo e ricavatene rapidamente il payload JSON che vi serve per verificare il funzionamento di un'interfaccia.

Preparare dati da caricare in un database NoSQL

I database orientati ai documenti come MongoDB lavorano con JSON, perciò un elenco costruito in un foglio di calcolo si converte direttamente in dati pronti al caricamento.

Creare dati fittizi per il front-end

Preparate in un attimo l'array JSON destinato alle schermate di prova e ai test, partendo da un elenco messo insieme in Excel.

Una conversione occasionale senza scrivere codice

È altrettanto comodo per una singola piccola conversione da CSV a JSON che non giustifica affatto scrivere codice sul momento.

I termini impiegati qui

CSV: Sigla di Comma-Separated Values, un formato che rappresenta dati tabellari separando i valori con virgole. È largamente impiegato per leggere e scrivere nei fogli di calcolo.
JSON: Sigla di JavaScript Object Notation, un formato leggero che rappresenta i dati soprattutto tramite coppie di chiave e valore. La maggior parte dei linguaggi di programmazione e delle interfacce lo tratta come cosa ovvia.
TSV: Sigla di Tab-Separated Values, un formato che rappresenta dati tabellari separando i valori con caratteri di tabulazione. Quando i valori contengono virgole, i confini restano meno ambigui rispetto al CSV.
RFC 4180: La specifica che fissa il formato consueto di un file CSV. Stabilisce come trattare virgole, interruzioni di riga e virgolette all'interno delle celle racchiuse tra virgolette doppie.
Riga di intestazione: La riga collocata per prima in un CSV, che indica il nome di ciascuna colonna. Nella conversione in JSON i suoi valori diventano i nomi delle chiavi degli oggetti.
Escape: Quando si vuole che una virgoletta doppia faccia parte di un valore del CSV, la si scrive due volte (""). Il parser la riporta a una singola virgoletta doppia.

Domande frequenti

Per impostazione predefinita la prima riga è trattata come intestazione e ciascuna riga successiva diventa un oggetto nella forma «nome dell'intestazione: valore»; l'insieme è racchiuso in un vettore. È il formato consueto per le risposte delle interfacce di programmazione e per l'immissione di dati nelle basi di dati non relazionali.

Sì. Scegliendo la tabulazione come carattere separatore, anche i file TSV si convertono direttamente in JSON.

Sì: poiché nel file CSV ogni valore è trattato come testo, anche ciò che sembra un numero o un valore logico compare nel JSON come stringa, per esempio "123" oppure "true". Se vi occorrono come numeri, convertiteli di tipo nel JSON dopo la trasformazione.

No. La conversione avviene interamente nel JavaScript del navigatore e quanto inserite non viene mai trasmesso ad alcun servente: potete usare lo strumento con serenità anche su dati personali.

A proposito — perché le interfacce di programmazione preferiscono JSON al CSV

Il formato CSV rappresenta con semplicità i dati tabellari, ma ha un limite: non sa esprimere strutture annidate, cioè vettori od oggetti dentro altri oggetti. Le risposte della maggior parte delle interfacce REST adottano JSON proprio perché consentono di incorporare liberamente vettori e oggetti in un singolo elemento, trasmettendo così anche strutture complesse che il CSV non riuscirebbe a rappresentare.

Il CSV, per contro, ha vantaggi difficili da rinunciare: si apre subito in Excel o in un foglio di calcolo e, avendo una riga per elemento, si legge facilmente a occhio. Nella pratica si è consolidata una divisione dei compiti — CSV per i conteggi e le verifiche, JSON per l'integrazione fra sistemi — ed è per questo che la domanda di conversione reciproca non si esaurisce mai.

Malgrado il nome, che rimanda a JavaScript, JSON è oggi supportato in modo standard da quasi tutti i linguaggi. Da quando Douglas Crockford ne pubblicò la specifica nel 2001, è stato deliberatamente progettato come rappresentazione minima dei dati indipendente da qualunque linguaggio: è questa la ragione principale della sua diffusione.

Vedi tutte le curiosità