Cookies para estatística e publicidade
Usamos cookies de estatística e de publicidade, ambos enviados ao Google. Recusar não muda nada do que você vê.Ler a página de privacidade
NDJSON
O que é um arquivo NDJSON?
Um objeto JSON por linha. É o que esteiras de log e exportações de dados emitem.
O que é NDJSON
NDJSON é um formato de texto puro que abre em qualquer editor. Ele é usado para mover dados entre programas e a transmissão.
A extensão é .ndjson e o nome por extenso é Newline-Delimited JSON. Os dois importam menos do que aquilo que o arquivo consegue carregar, e é disso que trata o resto desta página.
De onde vem NDJSON
Ele remonta a 2013.
A idade interessa por um motivo prático: quanto mais antigo o formato, mais programas tiveram tempo de aprendê-lo.
A especificação é pública
Qualquer um pode implementá-la sem pedir permissão nem pagar licença. É por isso que o formato aparece em tantos programas, e é por isso que arquivos escritos há vinte anos ainda abrem.
Nada é jogado fora
NDJSON guarda o conteúdo exatamente. Salvar de novo não muda nada, então dá para abrir, editar e salvar quantas vezes você quiser sem acumular estrago — e é isso que faz dele um formato de trabalho e não de entrega.
O que mais ele carrega
NDJSON consegue carregar um arranjo que permite começar a tocar antes de ter chegado por inteiro.
Isso conta sobretudo na conversão: o que o destino não comporta é descartado, quase sempre sem aviso.
Não há onde deixar uma anotação
NDJSON não tem sintaxe de comentário. Tudo que explica precisa morar fora do arquivo, e é bom saber disso antes de escolhê-lo para algo que uma pessoa vai editar na mão.
O que abre NDJSON
jq e pandas leem esse formato, e a maioria dos programas do mesmo tipo também.
Quando um arquivo não abre, o formato raramente é o problema — mais comum é o programa ser mais antigo que ele. Converter para algo mais antigo é o caminho confiável, e é para isso que serve o resto deste site.
Abrir no navegador
Nenhum navegador lê o formato.
Esse é de longe o motivo mais comum para convertê-lo: não que o formato seja ruim, mas que o lugar onde você quer mostrar o arquivo não consegue lê-lo.
É um formato de trabalho
NDJSON foi feito para ser aberto e alterado. Mantenha o arquivo nesse formato enquanto o trabalho estiver em andamento e exporte a partir dele sempre que precisar de uma cópia pronta.
Os dados, num lugar só
| Extensão | .ndjson, .jsonl |
|---|---|
| Tipo de mídia | application/x-ndjson |
| Primeira publicação | 2013 |