Lição 2
Cabeçalhos, delimitadores e linhas
Leia a forma da tabela antes de converter: cabeçalho, vírgula, tab, ponto e vírgula e pipe.
Antes de converter CSV, confirme a forma da tabela.
Cabeçalhos
Quando a primeira linha traz nomes, o CSV pode virar um array de objetos JSON:
id,name
1,Ada
2,Grace
[
{ "id": "1", "name": "Ada" },
{ "id": "2", "name": "Grace" }
]
Sem cabeçalho, a forma JSON mais segura é array de arrays ou nomes de coluna gerados. Nomes gerados ajudam na depuração, mas raramente viram contrato final de API.
Delimitadores
Nem todo arquivo tabular usa vírgula:
- Vírgula: CSV comum
- Tab: exportações TSV
- Ponto e vírgula: comum em alguns locales de planilha
- Pipe: logs e exportações internas
Detecção automática ajuda, mas em arquivos pequenos ou ambíguos escolha o delimitador manualmente.
Consistência de linhas
Cada linha de dados deve ter o número esperado de campos. Se o cabeçalho tem cinco colunas e uma linha tem seis valores, algo provavelmente quebrou: aspas faltando, delimitador errado ou trecho colado indevidamente.
Resumo
Cabeçalhos definem chaves de objeto, delimitadores definem limites de campo e consistência de linhas evita perda silenciosa de dados.
Use a prévia em tabela do Conversor CSV ↔ JSON para validar a forma antes de copiar a saída.