§

Cole o CSV que você quer converter para JSON.

Delimitador
A primeira linha é cabeçalho
Coerção de tipos
§

Output

json

Converter CSV para JSON é tarefa diária no ecossistema brasileiro de dados: os microdados do IBGE chegam em CSV antes que uma equipe os transforme em JSON para carregar no BigQuery, as bases do portal dados.gov.br alternam os dois formatos e os arquivos do Tesouro Transparente são entregues em CSV. Equipes que integram Pix e Open Finance Brasil pivotam continuamente listas de transações entre CSV (que auditores esperam) e JSON (que a API do Banco Central fala). Em Portugal, os datasets do dados.gov.pt, as séries do INE e os ficheiros do Banco de Portugal repetem o mesmo padrão. Este conversor analisa o CSV localmente, mantendo dados fiscais ou contábeis fora de servidores de terceiros.

O que é a conversão de CSV para JSON?

CSV (Comma-Separated Values, RFC 4180) é um formato de texto plano e tabular; JSON (JavaScript Object Notation, RFC 8259) é um formato de texto em forma de árvore para dados estruturados. Converter CSV para JSON transforma uma tabela compatível com planilhas em um array de objetos compatível com APIs — um objeto por linha, com o cabeçalho fornecendo as chaves — sem redigitar uma única célula.

Como funciona a conversão de CSV para JSON?

Cada conversão é executada localmente no seu navegador. Os passos principais são:

  1. Você cola o CSV no painel de entrada e pressiona CONVERTER; a ferramenta analisa o texto e emite um array JSON de objetos no painel de saída.
  2. Uma máquina de estados caractere por caractere (FIELD_START → IN_UNQUOTED_FIELD ou IN_QUOTED_FIELD) percorre a entrada, respeita o escape de aspas "", reconhece tanto \r\n quanto \n como terminadores de linha e produz uma matriz 2-D de strings como representação intermediária.
  3. Se a primeira linha for marcada como cabeçalho, suas células se tornam as chaves dos objetos; caso contrário a ferramenta gera chaves sintéticas field0, field1, … para que cada linha continue mapeada para um objeto completo.
  4. O delimitador (vírgula, ponto e vírgula, tabulação, barra vertical ou detecção automática) e a coerção de tipos (números / booleanos / null) são configuráveis. Com coerção ativada, 30 se torna o número 30 e true se torna booleano; com ela desativada, cada célula permanece como string.
  5. A saída é escrita na área de texto somente leitura como texto formatado com JSON.stringify, e um link de download cria um Blob com o tipo MIME application/json;charset=utf-8 para que você possa salvar o resultado com um clique.

Por que converter CSV para JSON com esta ferramenta?

  • Privacidade: cada passagem de análise e transformação acontece no seu navegador. Os dados nunca chegam aos nossos servidores.
  • Correção: o parser CSV é uma máquina de estados real. Campos contendo vírgulas entre aspas ("Bob, Jr."), quebras de linha embutidas e aspas escapadas são analisados como uma única célula, não três — implementações ingênuas com split(',') erram nesse ponto.
  • Fidelidade de tipos: a coerção opcional converte células numéricas e booleanas em números e booleanos JSON reais, de modo que o array resultante está pronto para consumo direto sem uma segunda passagem de limpeza.
  • Flexibilidade: escolha qualquer delimitador para dialetos CSV diferentes do de vírgula, configure se a primeira linha é cabeçalho e ative ou desative a coerção de tipos para casos em que cada célula precisa permanecer uma string.

Quais são as aplicações comuns da conversão de CSV para JSON?

Analisar CSV para obter JSON aparece em todo o trabalho com dados e ferramentas:

  • Mock de APIs: colar um fixture CSV exportado de uma planilha e convertê-lo em um array JSON que seu servidor local possa retornar como endpoint simulado.
  • Importação de dados: converter uma exportação de planilha (contatos, inventário, respostas de pesquisa) em um array JSON que sua aplicação ou script possa iterar sem dependência de um parser CSV.
  • Edição de configuração: permitir que revisores não técnicos editem configurações ou feature flags célula a célula em uma planilha, depois converter o CSV salvo para o JSON que seu app realmente carrega.

Como é um exemplo de conversão de CSV para JSON?

Colar name,age na primeira linha, Alice,30 na segunda e "Bob, Jr.",25 na terceira, depois pressionar CONVERTER com delimitador vírgula, primeira linha como chaves e coerção ativada, produz [{"name":"Alice","age":30},{"name":"Bob, Jr.","age":25}] — a vírgula entre aspas em "Bob, Jr." permanece dentro de um campo, e as idades se tornam números JSON reais.

Este conversor de CSV para JSON roda inteiramente no meu navegador?

Sim. Cada passagem de análise e transformação roda localmente como JavaScript dentro da sua aba do navegador. A ferramenta não chama fetch, XMLHttpRequest ou navigator.sendBeacon em nenhum momento — seu payload CSV nunca chega aos nossos servidores, a um conversor de terceiros ou a qualquer pipeline de analytics. A ferramenta também funciona offline depois que a página carregou, porque é um bundle estático HTML/CSS/JS sem dependência de API em tempo de execução.

Qual é o tamanho máximo de entrada que este conversor consegue processar?

O conversor armazena toda a entrada na memória e roda de forma síncrona na thread principal, então os limites práticos dependem do seu dispositivo. Entradas de até cerca de 10 MB de CSV (aproximadamente 100.000 linhas típicas) convertem sem pausa perceptível em um laptop moderno. Além disso, a interface pode travar enquanto o parser executa. Conversão em streaming usando um Web Worker mais um parser por chunks é um próximo passo planejado — por enquanto, divida conjuntos de dados muito grandes antes de colá-los.

Como o parser de CSV para JSON lida com vírgulas entre aspas e quebras de linha embutidas?

O parser é uma máquina de estados caractere por caractere com três estados (FIELD_START, IN_UNQUOTED_FIELD, IN_QUOTED_FIELD) — não um split(',') ingênuo. Um campo envolto em aspas duplas pode conter o delimitador, um CR, um LF ou uma aspa dupla literal escapada como "", sem quebrar os limites do campo. Assim, "Bob, Jr.",25 é analisado como dois campos, não três, e uma descrição multilinha entre aspas que cruza várias linhas é analisada como uma única célula.

Como são tipados números, booleanos e células vazias na saída JSON?

A tipagem é controlada pelo toggle Coerção de tipos. Com coerção ativada (o padrão), uma célula que parece um número se torna um número JSON, true/false se tornam booleanos e o literal null se torna null JSON; todo o resto permanece como string. Com coerção desativada, cada valor é mantido como string independentemente do seu conteúdo — útil quando zeros iniciais, telefones ou códigos de ID precisam sobreviver intactos. Células finais faltantes em uma linha curta são emitidas como strings vazias para que cada objeto tenha o conjunto completo de chaves.

Quais delimitadores o lado CSV suporta?

Quatro delimitadores explícitos são suportados: vírgula (,, o padrão da RFC 4180), ponto e vírgula (;, comum em locales europeus), tabulação (\t, o dialeto TSV) e barra vertical (|). Você também pode escolher Detecção automática, que conta as ocorrências de cada candidato nos primeiros 4 KB de entrada fora de regiões entre aspas e escolhe o mais frequente que produza uma contagem de colunas consistente nas primeiras cinco linhas.

Este conversor de CSV para JSON analisa com uma máquina de estados real e emite JSON limpo e pronto para consumo que você pode colar diretamente em uma chamada de API, em um script ou em uma revisão de código — sem enviar um único byte.