O que faz
Converte entre JSON e CSV nas duas direções. JSON → CSV recebe um array de objetos (ou um objeto único) e produz uma tabela: a união de todas as chaves vira a linha de cabeçalho, e uma linha segue para cada objeto. CSV → JSON interpreta a citação RFC 4180 e reconstrói um array de objetos. Um botão Swap inverte a direção e leva a saída atual como a nova entrada, então um documento faz a viagem de ida e volta sem copiar e colar. Uma linha de estatísticas sob a grade conta linhas ou itens e o tamanho da saída em bytes.
Como usar
- Escolha a direção com o controle segmentado: JSON → CSV ou CSV → JSON. Swap faz o mesmo e move a saída atual para a entrada.
- Cole seu documento no painel esquerdo.
- O resultado convertido aparece ao vivo à direita. Copiar leva-o.
- Leia a linha de estatísticas:
N rows · M bytespara JSON → CSV,N items · M bytespara CSV → JSON.
Exemplos
[{"name":"ada","role":"admin"},{"name":"bob","role":"user"}]
vira:
name,role
ada,admin
bob,user
Linha de estatísticas: 2 rows · 28 bytes.
Um campo contendo uma vírgula, uma aspa ou uma nova linha é citado conforme a RFC 4180: [{"price":"1,000"}] vira price na linha de cabeçalho e "1,000" na linha de dados. CSV → JSON reverte a citação exatamente.
Como o modelo de tabela funciona
Ambos os formatos expressam a mesma forma: uma tabela de linhas com colunas nomeadas. JSON a escreve como um array de objetos; CSV a escreve como uma linha de cabeçalho mais uma linha por registro:
| Conceito | JSON | CSV |
|---|---|---|
| tabela | array de objetos | o arquivo inteiro |
| coluna | chave do objeto | entrada do cabeçalho |
| linha | um objeto | uma linha |
| célula | valor | campo |
JSON → CSV percorre a entrada uma vez e coleta cada chave que encontra, em ordem de primeira aparição, como cabeçalho. Um objeto sem uma chave recebe uma célula vazia.
É aí que os formatos deixam de ser equivalentes, porque células CSV são texto puro:
- Um objeto ou array aninhado vira sua forma em string (
[object Object],1,2) e não volta. - Números e booleanos viram texto: o valor
1volta como a string"1". - Uma célula CSV vazia volta como
"".
Então JSON → CSV → JSON é com perdas sempre que os valores são mais que strings ou números simples. Use o par para dados tabulares, e mantenha documentos aninhados em JSON.
Bom saber
- Determinístico: a ordem das colunas segue a primeira aparição de cada chave; a saída usa quebras de linha
\n, sem nova linha final. - Verificação de ida e volta: converta em uma direção, pressione Swap, converta de volta e compare os dois documentos para ver exatamente o que uma planilha manteria.
- Privado: toda a conversão roda localmente no seu navegador.
- Ferramentas relacionadas: JSON Formatter, JSON Validator, JSON Minify.