CSV a JSON: da planilha aos dados estruturados

A linha do cabeçalho se torna suas chaves

A primeira linha fornece os nomes das propriedades JSON e cada linha seguinte se torna um objeto. Isso significa que a higiene do cabeçalho é um design de esquema: espaços, nomes duplicados e pontuação nos cabeçalhos produzem chaves que você não pode consumir confortavelmente. Renomeie para `snake_case` ou `camelCase` antes de converter e confirme se duas colunas não compartilham o mesmo nome — um cabeçalho duplicado é substituído silenciosamente na maioria das implementações.

Tudo em CSV é uma string

CSV não possui nenhum tipo, então um conversor decide como interpretar cada coluna. Os números se tornam números para que você possa fazer aritmética; `true`/`false` tornam-se booleanos; os campos vazios tornam-se `null` ou uma string vazia dependendo da sua escolha. A armadilha são os identificadores: códigos postais, números de telefone, números de faturas e strings de versão como `1.10` devem permanecer strings, ou você perderá os zeros à esquerda e o significado final. Se uma coluna parecer numérica, mas for um identificador, mantenha-a como texto.

Citações, vírgulas e novas linhas

A RFC 4180 resolveu isso há décadas: se um campo contiver uma vírgula, uma aspa ou uma quebra de linha, ele será colocado entre aspas duplas e as aspas internas serão duplicadas. Qualquer analisador compatível - Papa Parse é o incluído aqui - lida com campos agrupados com vírgulas incorporadas e células multilinhas sem pensar duas vezes. Um analisador que se divide ingenuamente por vírgulas produzirá colunas que mudam assim que um campo de endereço contém uma vírgula, que é o bug clássico “por que meus dados são compensados ​​​​por um”.

Os delimitadores variam de acordo com o local: planilhas em muitos locais europeus exportam arquivos separados por ponto e vírgula e TSV usa guias. Se cada linha for resumida em uma chave longa, o delimitador está errado – escolha ponto-e-vírgula ou tabulação e execute novamente.

De onde vêm os CSV arquivos (e o que eles carregam)

As exportações de ferramentas analíticas, sistemas de CRM, plataformas de cobrança e bancos de dados são a fonte mais comum – e geralmente contêm nomes de clientes, e-mails e números de receitas. A conversão local mantém esses dados totalmente fora da rede. O conversor YamlBox CSV para JSON analisa no navegador, permite escolher o delimitador e o tratamento de tipo e continua trabalhando com a rede desativada.

Dimensionando expectativas

Um arquivo CSV é aproximadamente um objeto JSON por linha, então o documento convertido é maior – as teclas se repetem em cada linha e a impressão bonita adiciona recuo no topo. Para um arquivo grande o suficiente para fazer seu navegador pausar, converter um array de objetos e depois minificar dá o menor resultado prático, e converter para JSON Linhas (um objeto por linha, sem array) é o formato correto se um fluxo ou pipeline de log for o próximo consumidor.