O que é
O Conversor CSV / JSON é uma ferramenta que transforma dados tabulares em CSV para um array de objetos JSON, e também faz o caminho inverso, de JSON para CSV. Tudo acontece no seu navegador, sem envio de dados para nenhum servidor. Você cola o conteúdo, escolhe o sentido da conversão e o resultado aparece na hora, pronto para copiar.
Use quando precisar migrar uma planilha para uma API, alimentar um front-end com dados de uma tabela ou converter uma resposta JSON de volta para um formato que abre no Excel. A conversão é imediata: o resultado se atualiza a cada tecla, sem botão de "converter".
Como usar
Siga estes passos:
- Escolha o sentido no botão "Alternar" (CSV para JSON ou JSON para CSV).
- Cole seu conteúdo no campo "Entrada".
- Leia o resultado no campo "Saída", que se preenche automaticamente.
- Clique no botão de copiar no canto da saída para levar o texto adiante.
O botão "Alternar" também joga a saída atual de volta para a entrada. Assim você converte CSV para JSON e, com um clique, testa o caminho de volta com o mesmo dado.
Exemplo trabalhado. Com esta entrada CSV:
nome,idade,cidade
João,30,São Paulo
Maria,25,Rio de Janeiro
A saída JSON gerada é indentada, com cada chave em sua própria linha:
[
{
"nome": "João",
"idade": "30",
"cidade": "São Paulo"
},
{
"nome": "Maria",
"idade": "25",
"cidade": "Rio de Janeiro"
}
]
Repare que "São Paulo" e "Rio de Janeiro" ficam intactos, com o espaço preservado. Os números viram texto entre aspas, como "30", porque cada campo do CSV é lido como string.
Como funciona
Na conversão de CSV para JSON, a ferramenta separa as linhas por quebra de linha e ignora linhas vazias. A primeira linha vira o cabeçalho, que define as chaves de cada objeto. As demais viram os objetos do array.
O separador de colunas é sempre a vírgula. O parser respeita aspas duplas: se um valor contém vírgula, coloque-o entre aspas para que ele não seja quebrado em duas colunas. Aspas literais dentro de um valor são escritas em dobro (""). Cada campo tem os espaços das pontas removidos, mas espaços internos permanecem. Se uma linha tiver menos colunas que o cabeçalho, as chaves faltantes recebem string vazia.
No sentido JSON para CSV, a entrada precisa ser um array de objetos. As colunas saem das chaves do primeiro objeto do array. Valores que contêm vírgula, aspas ou quebra de linha são automaticamente envolvidos em aspas, com as aspas internas duplicadas. Objetos aninhados são convertidos para texto na célula correspondente.
| Situação na entrada | O que acontece |
|---|---|
| Valor com espaço (São Paulo) | Mantido intacto |
| Valor entre aspas com vírgula | Tratado como um único campo |
Aspas duplas escapadas ("") |
Viram uma aspa simples |
| Linha com colunas a menos | Chaves faltantes viram string vazia |
| JSON que não é array de objetos | Mensagem de erro amigável |