Door Jerry Fan

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

EigenschapJSONJSONL (JSON Lines)
StructuurEén object of arrayEén JSON-object per regel
Bestandsextensie.json.jsonl of .ndjson
ParsingHet hele bestand in één keer parsenRegel voor regel parsen
StreamingLastigStandaard ondersteund
Grote bestanden verwerkenVeel geheugengebruikWeinig geheugengebruik
Leesbaar voor mensenOpgemaakt met inspringingCompact, één record per regel
SchemavalidatieOndersteunt JSON SchemaJSON Schema per regel
Gegevens toevoegenHet hele bestand herschrijvenEen 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.

Voorbeeld van JSON
[
  {"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.

Voorbeeld van JSONL
{"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

JSON

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

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

JSON

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

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

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

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

JSON

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.

JSONL

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

JSON ondersteunt pretty-printing met inspringing. Dat maakt configuratiebestanden en API-responses goed leesbaar.

JSONL

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?

JSONGebruik JSON als je:
  • 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
JSONLGebruik JSONL als je:
  • 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

JSONL

JSONL 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

JSONL

JSONL 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

JSON

REST 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

JSONL

Datapipelines, 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

JSON lezen in JavaScript
// Reading JSON - must load entire file
const data = JSON.parse(fs.readFileSync('data.json', 'utf8'));


// Access data
data.forEach(item => {
  console.log(item.name);
});
JSONL lezen in JavaScript
// 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 naar JSONL converteren
// 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 naar JSON converteren
// 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));

Probeer onze JSONL-viewer

Bekijk en bewerk JSONL-bestanden tot 1GB direct in je browser. Je hoeft niets te uploaden of een account aan te maken.

Veelgestelde vragen

Bronnen