Convertire JSON in CSV

Questo convertitore rigoroso ricava l'intestazione dalle chiavi del primo oggetto, verifica che ogni oggetto abbia esattamente le stesse chiavi e gestisce virgole, virgolette e interruzioni di riga secondo le regole CSV. Array vuoti, valori annidati, JSON non valido e record incompatibili producono un errore chiaro anziché un foglio ambiguo. La stessa conversione deterministica è disponibile nel browser e tramite API.

Prepari un array uniforme di oggetti piatti

Parta da un JSON valido il cui valore principale sia un array. Ogni elemento deve essere un oggetto e ogni campo deve contenere uno scalare JSON: stringa, numero, valore booleano o null. Gli oggetti e gli array annidati vengono rifiutati intenzionalmente, perché non esiste un unico modo corretto per inserirli in una cella CSV. Alcuni convertitori trasformano i valori annidati in testo, mentre altri appiattiscono i percorsi o moltiplicano le righe; ogni scelta modifica il significato dei dati. Questo strumento rimane prevedibile richiedendo che la forma tabellare sia esplicita prima della conversione. L'array deve contenere almeno un oggetto e il primo oggetto deve avere almeno una chiave. L'ordine delle sue chiavi diventa l'ordine delle colonne CSV, quindi disponga il primo record come desidera che appaia il foglio. L'ordine delle chiavi dell'oggetto JSON viene conservato. I valori possono includere virgole, virgolette, ritorni a capo o interruzioni di riga; non deve applicare manualmente l'escape per CSV, perché il serializzatore lo esegue dopo l'analisi del JSON.

Comprenda la convalida rigorosa di intestazioni e righe

La riga di intestazione deriva esclusivamente dalle chiavi del primo oggetto. Ogni oggetto successivo viene quindi confrontato con tale intestazione come insieme completo di chiavi. Un record con una chiave mancante non è valido, così come uno con una chiave aggiuntiva, anche se il valore aggiuntivo è vuoto o null. L'ordine delle chiavi negli oggetti successivi non conta: i valori vengono sempre emessi nell'ordine delle colonne del primo oggetto. Questo controllo rigoroso impedisce una categoria insidiosa di errori di esportazione. Un convertitore permissivo potrebbe creare un'unione crescente di colonne, lasciare vuoti inspiegabili o spostare i dati in base al record che introduce una proprietà. Qui, un input irregolare si arresta con un errore che identifica l'elemento incompatibile. null è ammesso come valore piatto intenzionale e produce una cella CSV vuota. Le chiavi assenti non vengono considerate null, perché l'assenza e un null esplicito possono rappresentare stati diversi nel sistema di origine. Convalidi o normalizzi a monte i record irregolari.

Utilizzi il CSV in sicurezza nei fogli e nei flussi

Dopo la convalida, ogni intestazione e valore viene serializzato come cella CSV. Le celle che contengono virgola, virgolette, ritorno a capo o interruzione di riga vengono racchiuse tra virgolette doppie, mentre le virgolette interne vengono raddoppiate. Numeri e booleani usano la loro rappresentazione testuale JSON, mentre null genera una cella vuota. Il risultato contiene una riga di intestazione seguita da una riga per oggetto, unite da caratteri di nuova riga. Poiché l'algoritmo è deterministico e non usa rete, orologio, casualità, modelli o servizi esterni, input identici producono output identici. È quindi adatto a test, esportazioni pianificate, fasi di build e consegne di dati ripetibili. Nel browser, incolli il JSON e copi il CSV generato senza inviare altrove i dati. Per l'automazione, richiami l'API al prezzo pubblicato di $0.002 per richiesta. Salvi il testo restituito con estensione .csv, quindi lo apra o lo importi impostando la virgola come delimitatore.