JSON vs JSONL: wat is het verschil?
Een complete handleiding over JSON en JSONL (JSON Lines): hoe de formaten werken, waarin ze verschillen en wanneer je welk formaat gebruikt.
Vergelijking in het kort
| Eigenschap | JSON | JSONL (JSON Lines) |
|---|---|---|
| Structuur | Eén object of array | Eén JSON-object per regel |
| Bestandsextensie | .json | .jsonl of .ndjson |
| Parsing | Het hele bestand in één keer parsen | Regel voor regel parsen |
| Streaming | Lastig | Standaard ondersteund |
| Grote bestanden verwerken | Veel geheugengebruik | Weinig geheugengebruik |
| Leesbaar voor mensen | Opgemaakt met inspringing | Compact, één record per regel |
| Schemavalidatie | Ondersteunt JSON Schema | JSON Schema per regel |
| Gegevens toevoegen | Het hele bestand herschrijven | Een nieuwe regel aan het einde toevoegen |
Wat is JSON?
JSON (JavaScript Object Notation) is een lichtgewicht formaat voor gegevensuitwisseling. Het is voor mensen makkelijk te lezen en te schrijven, en voor software eenvoudig te parsen en te genereren. Het is gebaseerd op een subset van JavaScript en is uitgegroeid tot de de facto standaard voor gegevensuitwisseling op het web.
Een JSON-bestand bevat één JSON-waarde, meestal een object of een array. Om de gegevens in het bestand te kunnen gebruiken, moet je het hele bestand als één geheel parsen.
[
{"name": "Alice", "age": 30, "city": "New York"},
{"name": "Bob", "age": 25, "city": "London"},
{"name": "Charlie", "age": 35, "city": "Tokyo"}
]Wat is JSONL (JSON Lines)?
JSONL (JSON Lines), ook bekend als Newline Delimited JSON (NDJSON), is een tekstformaat waarin elke regel een geldig JSON-object bevat. De regels worden gescheiden door newline-tekens (\n). Anders dan bij standaard JSON staan de gegevens niet samen in een overkoepelende array of een overkoepelend object.
Elke regel in een JSONL-bestand staat op zichzelf en kan afzonderlijk worden geparset. Dat maakt JSONL ideaal voor het streamen van gegevens, logbestanden en het verwerken van grote datasets zonder alles in het geheugen te laden.
{"name": "Alice", "age": 30, "city": "New York"}
{"name": "Bob", "age": 25, "city": "London"}
{"name": "Charlie", "age": 35, "city": "Tokyo"}Belangrijkste verschillen tussen JSON en JSONL
1. Bestandsformaat en structuur
Bij JSON staan alle gegevens samen in één object of array. Het bestand moet als geheel syntactisch geldig zijn: als aan het einde een sluithaak ontbreekt, is het hele bestand ongeldig.
JSONL slaat één JSON-object per regel op. Elke regel staat op zichzelf: als één regel een fout bevat, kun je de andere regels nog steeds parsen.
2. Parsen en geheugengebruik
Bij JSON moet je het hele bestand in één keer laden en parsen. Om een JSON-bestand van 1GB te parsen, heb je ongeveer 1GB+ aan geheugen nodig.
JSONL kun je regel voor regel lezen en parsen (streaming). Door steeds één regel te lezen, kun je zelfs een JSONL-bestand van 10GB met heel weinig geheugen verwerken.
3. Streaming en realtime gegevens
JSON is niet ontworpen voor streaming. Je kunt de gegevens pas verwerken als het volledige bestand of de volledige response is ontvangen en geparset.
JSONL is ideaal voor streaming. Je kunt elke regel verwerken zodra die binnenkomt. Daardoor is het uitstekend geschikt voor realtime datafeeds, logs en server-sent events.
4. Gegevens toevoegen en schrijven
Om gegevens aan een JSON-array toe te voegen, moet je het hele bestand lezen en parsen, het nieuwe element toevoegen en vervolgens het volledige bestand opnieuw schrijven.
Aan een JSONL-bestand voeg je eenvoudig een nieuwe regel toe aan het einde. Je hoeft de bestaande gegevens niet te lezen of aan te passen. Dit kost O(1), tegenover O(n) bij JSON.
5. Leesbaarheid voor mensen
JSON ondersteunt pretty-printing met inspringing. Dat maakt configuratiebestanden en API-responses goed leesbaar.
JSONL is bewust compact opgezet, met één record per regel. Het formaat is geoptimaliseerd voor verwerking door software en minder gericht op leesbaarheid voor mensen. Afzonderlijke regels kun je wel met pretty-printing opmaken.
Wanneer gebruik je JSON en wanneer JSONL?
- Met configuratiebestanden werkt
- Request- en responsebodies voor REST API's opstelt
- Kleine hoeveelheden gestructureerde gegevens opslaat (minder dan 10MB)
- Gegevens nodig hebt die mensen kunnen lezen en bewerken
- Met geneste, hiërarchische gegevensstructuren werkt
- Gegevens uitwisselt in de browser
- Grote datasets verwerkt (100MB+)
- Gegevens in realtime streamt
- Logbestanden en eventgegevens schrijft
- Machinelearningmodellen traint (OpenAI, Hugging Face)
- Met ETL-pipelines en gegevensverwerking werkt
- Vaak gegevens toevoegt
- Gegevens verwerkt met Unix-tools (grep, awk, sed)
Veelvoorkomende toepassingen
Machine learning en AI
JSONLJSONL is het standaardformaat voor ML-trainingsdata. OpenAI gebruikt JSONL voor datasets voor fine-tuning, en veel ML-frameworks verwachten invoer in JSONL-formaat. Elke regel bevat één trainingsvoorbeeld.
Applicatielogging
JSONLJSONL leent zich goed voor serverlogs, applicatie-events en audittrails. Elk event wordt op één regel geschreven. Daardoor kun je eenvoudig nieuwe events toevoegen, met grep zoeken en de gegevens met streamingtools verwerken.
Web-API's en configuratie
JSONREST API's gebruiken meestal JSON voor request- en responsebodies. Configuratiebestanden (.json) gebruiken JSON om instellingen leesbaar en gestructureerd op te slaan, met geneste objecten.
Big data en analyse
JSONLDatapipelines, ETL-processen en analysetools gebruiken JSONL om grote hoeveelheden gegevens te verwerken. Elk record kan afzonderlijk worden verwerkt. Dat maakt parallelle verwerking en MapReduce-patronen mogelijk.
Codevoorbeelden
// Reading JSON - must load entire file
const data = JSON.parse(fs.readFileSync('data.json', 'utf8'));
// Access data
data.forEach(item => {
console.log(item.name);
});// Reading JSONL - stream line by line
import { createReadStream } from 'fs';
import { createInterface } from 'readline';
const rl = createInterface({
input: createReadStream('data.jsonl')
});
for await (const line of rl) {
const item = JSON.parse(line);
console.log(item.name);
}// JSON array to JSONL
const jsonArray = JSON.parse(fs.readFileSync('data.json', 'utf8'));
const jsonl = jsonArray
.map(item => JSON.stringify(item))
.join('\n');
fs.writeFileSync('data.jsonl', jsonl);// JSONL to JSON array
const lines = fs.readFileSync('data.jsonl', 'utf8')
.split('\n')
.filter(line => line.trim());
const jsonArray = lines.map(line => JSON.parse(line));
fs.writeFileSync('data.json', JSON.stringify(jsonArray, null, 2));JSON en JSONL online converteren
Met onze gratis online tools converteer je direct tussen JSON en JSONL. Je hoeft niets te installeren.
Zet JSONL-bestanden om naar een standaard JSON-array. Ideaal voor API’s en dataverwerkingspipelines.
Zet JSON-arrays om naar JSONL. Ideaal om data voor te bereiden voor streaming en ML-training.
Lees wat JSONL (JSON Lines) is, hoe het verschilt van gewone JSON en waarom het zo vaak wordt gekozen voor het streamen van data, logbestanden en machinelearningdatasets.
Leer de best practices voor JSONL toepassen: opmaak, consistente schema’s, foutafhandeling, prestatieoptimalisatie en het organiseren van bestanden. Vermijd veelvoorkomende valkuilen aan de hand van praktische voorbeelden.
Strategieën om gigabytes aan JSONL-data te verwerken. Met aandacht voor lezen via streaming, geheugenbeheer, het splitsen van bestanden, compressie en online tools.