Door Jerry Fan

Wat is JSONL? Een complete gids voor het JSON Lines-formaat

Alles wat je moet weten over JSON Lines: syntaxis, voorbeelden, toepassingen en best practices.

Wat is JSONL?

JSONL (JSON Lines), ook bekend als Newline Delimited JSON (NDJSON), is een tekstformaat waarin elke regel een geldige JSON-waarde bevat. De regels worden gescheiden door newline-tekens. Standaard JSON brengt gegevens onder in één array of object; JSONL slaat één record per regel op.

Door deze eenvoudige opzet is JSONL ideaal voor streaming, logging en het verwerken van grote datasets. Je kunt elke regel afzonderlijk lezen, parsen en verwerken, zonder het hele bestand in het geheugen te laden.

Het formaat is populair geworden door tools en platforms die grote hoeveelheden data verwerken, zoals OpenAI (voor datasets voor fine-tuning), BigQuery, Apache Spark en systemen voor logbeheer.

Syntaxisregels voor JSONL

Voor het JSONL-formaat gelden een paar eenvoudige regels:

  • Elke regel moet een geldige JSON-waarde bevatten (object, array, string, getal, boolean of null)
  • Regels worden gescheiden door newline-tekens (\n)
  • Tussen de regels staan geen komma's of andere scheidingstekens
  • Bestanden moeten UTF-8 als tekencodering gebruiken
  • Een newline aan het einde van het bestand is optioneel
  • De meeste parsers negeren lege regels
Geldig JSONL-bestand
{"name":"Alice","age":30,"city":"New York"}
{"name":"Bob","age":25,"city":"London"}
{"name":"Charlie","age":35,"city":"Tokyo"}

Let op: elke regel is een volledig, zelfstandig JSON-object. Tussen de regels staan geen komma's en er staat geen array om het geheel heen.

JSONL-voorbeelden

Eenvoudige objecten
{"id":1,"name":"Alice","email":"[email protected]"}
{"id":2,"name":"Bob","email":"[email protected]"}
{"id":3,"name":"Charlie","email":"[email protected]"}
Geneste objecten
{"user":{"name":"Alice","age":30},"scores":[95,87,92]}
{"user":{"name":"Bob","age":25},"scores":[88,91,76]}

De regels in een JSONL-bestand hoeven niet allemaal hetzelfde datatype te bevatten, zolang elke regel maar geldige JSON bevat:

Verschillende datatypes
{"event":"login","user":"alice","timestamp":"2026-01-15T10:30:00Z"}
{"event":"purchase","user":"alice","amount":29.99,"items":["book","pen"]}
{"event":"logout","user":"alice","timestamp":"2026-01-15T11:45:00Z"}

Een van de populairste toepassingen van JSONL is het opslaan van datasets voor fine-tuning bij OpenAI:

PopularFormaat voor fine-tuning bij OpenAI
{"messages":[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"What is JSONL?"},{"role":"assistant","content":"JSONL is a text format where each line is a valid JSON value."}]}
{"messages":[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"How do I read a JSONL file?"},{"role":"assistant","content":"Read the file line by line, parsing each line as JSON."}]}

JSONL-bestanden lezen

Je kunt JSONL-bestanden lezen met elke tool die tekst regel voor regel kan verwerken. Dit zijn de meestgebruikte manieren:

Gebruik standaard Unix-tools om de inhoud van JSONL-bestanden te bekijken:

Command line
# View first 5 lines
head -n 5 data.jsonl


# Count total lines (records)
wc -l data.jsonl


# Pretty-print each line with jq
cat data.jsonl | jq .


# Filter by field value
cat data.jsonl | jq 'select(.age > 30)'

Met de ingebouwde json-module van Python kun je eenvoudig JSONL verwerken:

Python
import json


with open('data.jsonl', 'r') as f:
    for line in f:
        record = json.loads(line)
        print(record['name'])

Lees JSONL-bestanden regel voor regel in Node.js:

JavaScript / Node.js
import { createReadStream } from 'fs';
import { createInterface } from 'readline';


const rl = createInterface({
  input: createReadStream('data.jsonl')
});


for await (const line of rl) {
  const record = JSON.parse(line);
  console.log(record.name);
}

Online JSONL-viewer

Wil je de inhoud visueel doorbladeren? Met jsonl.co kun je JSONL-bestanden tot 1GB openen en bekijken. Je hoeft niets te uploaden: alles draait in je browser.

JSONL-bestanden maken

Een JSONL-bestand maken is eenvoudig: schrijf één JSON-waarde per regel.

Python
import json


records = [
    {"name": "Alice", "age": 30},
    {"name": "Bob", "age": 25},
    {"name": "Charlie", "age": 35},
]


with open('output.jsonl', 'w') as f:
    for record in records:
        f.write(json.dumps(record) + '\n')
JavaScript / Node.js
import { writeFileSync } from 'fs';


const records = [
  { name: 'Alice', age: 30 },
  { name: 'Bob', age: 25 },
  { name: 'Charlie', age: 35 },
];


const jsonl = records
  .map(r => JSON.stringify(r))
  .join('\n');


writeFileSync('output.jsonl', jsonl + '\n');

Kun je commentaar toevoegen aan JSONL?

Nee. De JSONL-specificatie ondersteunt geen commentaar. Elke regel in een JSONL-bestand moet een geldige JSON-waarde zijn, en JSON zelf heeft geen syntaxis voor commentaar.

Wil je metadata of annotaties bij je gegevens opnemen? Dit zijn veelgebruikte oplossingen:

  • 1Voeg een metadataveld toe aan je JSON-objecten: {"_comment": "testgegevens", "name": "Alice"}
  • 2Gebruik een apart metadatabestand naast je JSONL-bestand
  • 3Voeg metadata toe als de eerste regel van het bestand: {"_meta": {"version": "1.0", "created": "2026-01-15"}}

Houd er rekening mee dat velden met "commentaar" als gewone data worden geparsed. Applicaties die het JSONL-bestand verwerken, moeten zo zijn ingericht dat ze metadatavelden negeren.

JSONL versus JSON

Het belangrijkste verschil zit in de structuur. JSON bevat alle gegevens in één waarde, terwijl JSONL één waarde per regel opslaat.

JSONStandaard JSON
[
  {"name": "Alice", "age": 30},
  {"name": "Bob", "age": 25}
]
JSONLJSONL (JSON Lines)
{"name":"Alice","age":30}
{"name":"Bob","age":25}
  • Om JSON te parsen, moet je het hele bestand in het geheugen laden; JSONL kun je regel voor regel lezen
  • JSON gebruikt komma's tussen elementen; JSONL gebruikt newline-tekens
  • JSON is geschikter voor configuratiebestanden en API's; JSONL is geschikter voor grote datasets en streaming
  • Om gegevens aan JSON toe te voegen, moet je het hele bestand herschrijven; bij JSONL voeg je alleen een nieuwe regel toe

Lees voor een uitgebreide vergelijking onze volledige JSON vs JSONL guide.

Veelvoorkomende toepassingen

Machine learning en AI

Populairst

JSONL is het standaardformaat voor ML-trainingsdata. OpenAI, Hugging Face en andere AI-platforms gebruiken JSONL voor datasets voor fine-tuning. Elk trainingsvoorbeeld staat namelijk op een zelfstandige regel. Daardoor kun je de voorbeelden efficiënt in willekeurige volgorde zetten, er steekproeven uit nemen en ze streamen.

Logbestanden en eventstreams

JSONL

Systemen voor gestructureerde logging (ELK-stack, Datadog, CloudWatch) schrijven logs in JSONL-formaat. Elke logregel bevat één JSON-waarde. Daardoor kun je eenvoudig nieuwe logregels toevoegen en logs in realtime verwerken.

Big data verwerken

JSONL

Tools zoals Apache Spark, BigQuery en AWS Athena hebben ingebouwde ondersteuning voor JSONL. Doordat elke waarde op een eigen regel staat, kunnen gedistribueerde systemen de data parallel verwerken: elke worker kan zelfstandig een deel van de regels verwerken.

Streaming-API''s

JSONL

API's die grote hoeveelheden resultaten teruggeven, gebruiken vaak JSONL-streaming. De client kan resultaten verwerken zodra ze binnenkomen en hoeft dus niet op de volledige response te wachten.

JSONL-bestandsextensies

JSONL-bestanden hebben meestal een van deze extensies:

.jsonlDe standaardextensie voor JSONL en de meestgebruikte
.ndjsonNewline Delimited JSON: technisch gezien hetzelfde formaat, maar met een andere naam
.jsonSommige tools schrijven JSONL-bestanden met de extensie .json, wat voor verwarring kan zorgen

Bestanden met deze drie extensies gebruiken hetzelfde formaat: één JSON-waarde per regel. Het MIME-type voor JSONL is application/jsonl of application/x-ndjson.

Probeer onze JSONL-viewer

Open, bekijk en bewerk JSONL-bestanden tot 1GB, direct in je browser. Je hoeft niets te uploaden en alles blijft 100% privé.

Veelgestelde vragen

Bronnen