Cookies voor statistiek en advertenties
We gebruiken cookies voor statistiek en voor advertenties, allebei naar Google. Weigeren verandert niets aan wat je te zien krijgt.Lees de privacypagina
NDJSON
Wat is een NDJSON-bestand?
Eén JSON-object per regel. Wat logpijplijnen en gegevensuitvoer opleveren.
Wat NDJSON is
NDJSON is een puur tekstformaat dat in elke editor opengaat. Het wordt gebruikt voor gegevens tussen programma’s verplaatsen en streamen.
De extensie is .ndjson en de volledige naam Newline-Delimited JSON. Allebei zeggen ze minder dan wat het bestand kan bevatten, en daar gaat de rest van deze pagina over.
Waar NDJSON vandaan komt
Het gaat terug tot 2013.
De leeftijd is om een praktische reden interessant: hoe ouder een formaat, hoe meer programma’s de tijd hebben gehad om het te leren.
De specificatie is openbaar
Iedereen mag hem uitvoeren zonder te vragen en zonder licentie te betalen. Daarom duikt het formaat in zo veel programma’s op, en daarom gaan bestanden van twintig jaar geleden nog steeds open.
Er wordt niets weggegooid
NDJSON bewaart zijn inhoud precies. Opnieuw opslaan verandert niets, dus je kunt het zo vaak openen, bewerken en wegschrijven als je wilt zonder dat er schade opstapelt — en dat is wat er een werkformaat van maakt in plaats van een afleverformaat.
Wat het verder kan dragen
NDJSON kan een opbouw waarmee het kan beginnen af te spelen voordat het volledig is aangekomen bevatten.
Dat telt vooral bij het converteren: wat het doel niet kan bevatten valt weg, meestal zonder waarschuwing.
Er is nergens plaats voor een aantekening
NDJSON heeft geen commentaarsyntaxis. Alles wat toelicht moet buiten het bestand leven, en dat is goed om te weten voordat je het kiest voor iets dat een mens met de hand bijhoudt.
Wat NDJSON opent
jq en pandas lezen het, en de meeste programma’s van dezelfde soort ook.
Als een bestand niet opengaat ligt het zelden aan het formaat — vaker is het programma ouder dan het formaat. Converteren naar iets ouders is de betrouwbare weg eromheen, en daarvoor is de rest van deze site bedoeld.
Het in de browser openen
Geen enkele browser leest het.
Dat is veruit de meest voorkomende reden om het te converteren: niet dat het formaat slecht is, maar dat de plek waar je het bestand wilt tonen het niet kan lezen.
Het is een werkformaat
NDJSON is bedoeld om te openen en te wijzigen. Houd het bestand in dit formaat zolang het werk loopt, en exporteer eruit wanneer er een afgeronde versie nodig is.
De gegevens, op één plek
| Extensie | .ndjson, .jsonl |
|---|---|
| Mediatype | application/x-ndjson |
| Voor het eerst gepubliceerd | 2013 |