NDJSON

Qu’est-ce qu’un fichier NDJSON ?

Un objet JSON par ligne. Ce que font circuler les chaînes de journalisation et les exports de données.

Ce qu’est NDJSON

NDJSON est un format texte que n’importe quel éditeur ouvre. Il est utilisé pour l’échange entre programmes et la diffusion en continu.

L’extension est .ndjson et le nom complet Newline-Delimited JSON. L’un et l’autre comptent moins que ce que le fichier peut contenir, et c’est le sujet du reste de cette page.

D’où vient NDJSON

Il remonte à 2013.

L’âge est utile à connaître pour une raison pratique : plus un format est ancien, plus les programmes ont eu le temps de l’apprendre.

La spécification est publique

N’importe qui peut l’implémenter sans demander l’autorisation ni payer de licence. C’est pourquoi ce format apparaît dans tant de programmes, et pourquoi des fichiers écrits il y a vingt ans s’ouvrent encore.

Rien n’est jeté

NDJSON enregistre son contenu à l’identique. Le réenregistrer ne change rien : vous pouvez l’ouvrir, le modifier et le réenregistrer autant de fois que vous voulez sans accumuler de dégâts, et c’est ce qui en fait un format de travail plutôt qu’un format de livraison.

Ce qu’il peut porter d’autre

NDJSON peut contenir une disposition qui lui permet de commencer à jouer avant d’être arrivé en entier.

Cela compte surtout à la conversion : ce que la cible ne peut pas contenir est abandonné, en général sans avertissement.

Il n’y a nulle part où laisser une note

NDJSON n’a pas de syntaxe de commentaires. Tout ce qui explique doit vivre hors du fichier, ce qui est bon à savoir avant de le choisir pour quelque chose qu’un humain modifiera à la main.

Ce qui ouvre NDJSON

jq et pandas le lisent, comme la plupart des programmes du même genre.

Quand un fichier ne s’ouvre pas, le format est rarement en cause : le plus souvent, c’est le programme qui est plus ancien que lui. Convertir vers quelque chose de plus ancien est le contournement fiable, et c’est à cela que sert le reste de ce site.

L’ouvrir dans un navigateur

Aucun navigateur ne le lit.

C’est de loin la raison la plus fréquente de le convertir : non pas que le format soit mauvais, mais que l’endroit où vous voulez montrer le fichier ne sache pas le lire.

C’est un format de travail

NDJSON est fait pour être ouvert et modifié. Gardez le fichier dans ce format tant que le travail dure, et exportez depuis lui chaque fois qu’une version finie est nécessaire.

Les données, au même endroit

Identifiants et origine du format NDJSON.
Extension.ndjson, .jsonl
Type de médiaapplication/x-ndjson
Première publication2013

Convertir NDJSON en autre chose

Convertir autre chose en NDJSON

Formats à envisager à la place de NDJSON