CSV ⇄ JSON

O que faz o CSV ⇄ JSON

O CSV ⇄ JSON converte texto tabular em JSON estruturado e converte arrays JSON de volta num ficheiro CSV que pode colar numa folha de cálculo, numa ferramenta de importação, num dado de teste ou num exemplo de documentação. O analisador de CSV foi escrito para dados reais de programação e não apenas para os exemplos mais simples separados por vírgulas. Lê campos entre aspas, vírgulas incorporadas, aspas duplas com escape, células vazias e fins de linha CRLF e LF, para que as linhas copiadas de uma folha de cálculo e os relatórios exportados se comportem como esperado.

Na direção de CSV para JSON, a primeira linha é tratada por predefinição como nomes das colunas. Quando um ficheiro não tem linha de cabeçalho, o conversor gera nomes previsíveis como column1, column2 e column3. A direção de JSON para CSV aceita um array de objetos ou um array de arrays. Para objetos, obtém uma união estável das chaves pela ordem em que surgem e escreve essas chaves como linha de cabeçalho antes de preencher cada registo. Para arrays, escreve cada array aninhado como uma linha CSV.

Fluxo de trabalho privado no navegador

A análise, a validação, a colocação de aspas, a cópia e a transferência acontecem no seu navegador. A ferramenta não envia para nenhum servidor os seus CSV, JSON, identificadores, exemplos semelhantes a dados de clientes, tokens ou excertos de relatórios exportados. Este comportamento exclusivamente local é útil porque as ferramentas de conversão são muitas vezes usadas com dados de depuração realistas, respostas de API, exemplos de configuração e exportações de folhas de cálculo que não devem sair do seu computador. Mantém também o fluxo rápido, porque o resultado é gerado de imediato, sem esperar por um pedido de rede.

Dicas práticas

Use a deteção automática do delimitador quando não tiver a certeza se uma folha de cálculo exportou dados separados por vírgulas, pontos e vírgulas ou tabulações. Escolha um delimitador específico ao preparar o resultado para outro sistema com requisitos de importação rigorosos. Reveja sempre os dados convertidos antes de os usar em produção, sobretudo quando existem células vazias, nomes de cabeçalho duplicados, objetos com formas diferentes ou valores JSON com objetos aninhados. O CSV é uma família de formatos pouco rígida, pelo que um utilitário do navegador serve melhor para inspecionar, limpar e fazer pequenas transformações do que para substituir um processo de importação específico de um projeto.