Por Jerry Fan

JSON vs JSONL: ¿cuál es la diferencia?

Una guía completa para entender los formatos JSON y JSONL (JSON Lines), en qué se diferencian y cuándo usar cada uno.

Comparativa rápida

CaracterísticaJSONJSONL (JSON Lines)
EstructuraUn solo objeto o arrayUn objeto JSON por línea
Extensión de archivo.json.jsonl o .ndjson
Análisis sintácticoHay que parsear el archivo completoSe puede parsear línea por línea
StreamingDifícilSoporte nativo
Gestión de archivos grandesAlto consumo de memoriaUso eficiente de la memoria
LegibilidadFormato con sangríaCompacto, un registro por línea
Validación con esquemasCompatible con JSON SchemaValidación con JSON Schema por línea
Añadir datosHay que reescribir el archivo completoBasta con añadir una línea

¿Qué es JSON?

JSON (JavaScript Object Notation) es un formato ligero de intercambio de datos, fácil de leer y escribir para las personas y de parsear y generar para las máquinas. Se basa en un subconjunto de JavaScript y se ha convertido en el estándar de facto para intercambiar datos en la web.

Un archivo JSON contiene un único valor JSON, normalmente un objeto o un array. Para acceder a cualquiera de sus datos, hay que parsear el archivo completo como una sola unidad.

Ejemplo de JSON
[
  {"name": "Alice", "age": 30, "city": "New York"},
  {"name": "Bob", "age": 25, "city": "London"},
  {"name": "Charlie", "age": 35, "city": "Tokyo"}
]

¿Qué es JSONL (JSON Lines)?

JSONL (JSON Lines), también conocido como Newline Delimited JSON (NDJSON), es un formato de texto en el que cada línea contiene un objeto JSON válido. Las líneas se separan con caracteres de salto de línea (\n). A diferencia del JSON estándar, los datos no están contenidos en un array u objeto que los agrupe.

Cada línea de un archivo JSONL es autónoma y se puede parsear por separado. Por eso, JSONL resulta ideal para transmitir datos en streaming, guardar logs y procesar grandes conjuntos de datos sin cargarlos por completo en memoria.

Ejemplo de JSONL
{"name": "Alice", "age": 30, "city": "New York"}
{"name": "Bob", "age": 25, "city": "London"}
{"name": "Charlie", "age": 35, "city": "Tokyo"}

Diferencias clave entre JSON y JSONL

1. Formato y estructura del archivo

JSON

JSON agrupa todos los datos en un único objeto o array. El archivo debe tener una sintaxis válida en su conjunto: si falta un corchete al final, todo el archivo deja de ser válido.

JSONL

JSONL almacena un objeto JSON por línea. Cada línea es independiente: si una contiene un error, las demás se pueden seguir parseando.

2. Análisis sintáctico y consumo de memoria

JSON

JSON requiere cargar y parsear el archivo completo de una sola vez. Para parsear un archivo JSON de 1 GB, necesitarías aproximadamente 1 GB de memoria o más.

JSONL

JSONL permite leer y parsear los datos línea por línea (streaming). Incluso un archivo JSONL de 10 GB se puede procesar con un consumo mínimo de memoria si se lee una línea cada vez.

3. Streaming y datos en tiempo real

JSON

JSON no está diseñado para el streaming. No puedes empezar a procesar los datos hasta haber recibido y parseado el archivo o la respuesta completos.

JSONL

JSONL es ideal para el streaming. Cada línea se puede procesar en cuanto llega, por lo que encaja perfectamente con los flujos de datos en tiempo real, los logs y los eventos enviados por el servidor (server-sent events).

4. Adición y escritura de datos

JSON

Para añadir datos a un array JSON, hay que leer el archivo completo, parsearlo, añadir el nuevo elemento y volver a escribir todo el archivo.

JSONL

Para añadir datos a un archivo JSONL, basta con agregar una línea al final. No hace falta leer ni modificar los datos existentes. La complejidad es O(1), frente a O(n) en JSON.

5. Facilidad de lectura

JSON

JSON permite dar formato a los datos con sangría, lo que facilita mucho la lectura de archivos de configuración y respuestas de API.

JSONL

JSONL es compacto por diseño: un registro por línea. Está optimizado para que lo procesen las máquinas, aunque también puedes dar formato a cada línea por separado para facilitar su lectura.

Cuándo usar JSON y cuándo usar JSONL

JSONUsa JSON cuando:
  • Trabajes con archivos de configuración
  • Crees cuerpos de petición y respuesta para APIs REST
  • Almacenes pequeños conjuntos de datos estructurados (menos de 10 MB)
  • Necesites que las personas puedan leer y editar los datos
  • Trabajes con estructuras de datos jerárquicas y anidadas
  • Intercambies datos desde el navegador
JSONLUsa JSONL cuando:
  • Proceses grandes conjuntos de datos (100 MB o más)
  • Transmitas datos en tiempo real
  • Escribas archivos de logs y datos de eventos
  • Entrenes modelos de aprendizaje automático (OpenAI, Hugging Face)
  • Trabajes con pipelines ETL y procesamiento de datos
  • Añadas datos con frecuencia
  • Proceses datos con herramientas de Unix (grep, awk, sed)

Casos de uso comunes

Aprendizaje automático e IA

JSONL

JSONL es el formato estándar para los datos de entrenamiento de modelos de aprendizaje automático. OpenAI lo utiliza en los conjuntos de datos para fine-tuning, y muchos frameworks de aprendizaje automático esperan recibir los datos en JSONL. Cada línea representa un ejemplo de entrenamiento.

Logs de aplicaciones

JSONL

JSONL encaja de forma natural con los logs de servidor, los eventos de aplicaciones y los registros de auditoría. Cada evento se escribe en una sola línea, lo que facilita añadir nuevos eventos, buscar con grep y procesar los datos con herramientas de streaming.

APIs web y configuración

JSON

Las APIs REST suelen usar JSON en los cuerpos de las peticiones y las respuestas. Los archivos de configuración (.json) utilizan este formato para definir opciones legibles y estructuradas con objetos anidados.

Big Data y analítica

JSONL

Los pipelines de datos, los procesos ETL y las herramientas de análisis usan JSONL para procesar grandes volúmenes de datos. Como cada registro se puede procesar por separado, el formato permite el procesamiento en paralelo y el uso de patrones MapReduce.

Ejemplos de código

Leer JSON en 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);
});
Leer JSONL en 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);
}
Convertir JSON a JSONL
// 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);
Convertir JSONL a JSON
// 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));

Prueba nuestro visor de JSONL

Abre y edita archivos JSONL de hasta 1 GB al instante en tu navegador. Sin subir archivos ni registrarte.

Preguntas frecuentes

Referencias