JSON

¿Qué es JSON?

JSON (JavaScript Object Notation) es un formato ligero de intercambio de datos, basado en texto, fácil de leer y escribir para los humanos y fácil de analizar y generar para las máquinas. Aunque se deriva de JavaScript, JSON es independiente del lenguaje y es ahora el estándar de facto para el intercambio de datos en la web.

JSON representa datos como pares clave-valor organizados en objetos y arrays. Su simplicidad lo convirtió en el formato dominante para APIs REST, archivos de configuración y almacenamiento de datos, sustituyendo al más verboso XML en la mayoría de las aplicaciones modernas.

Una breve historia

JSON fue formalizado por Douglas Crockford a principios de los años 2000, aunque el formato ya era implícito en la sintaxis de JavaScript. La especificación se publicó en json.org en 2001. El RFC 4627 siguió en 2006, y el actual estándar ECMA-404 se publicó en 2013.

Antes de JSON, XML era el formato de intercambio de datos dominante en la web. El minimalismo de JSON —sin atributos, instrucciones de procesamiento ni espacios de nombres— lo hizo inmediatamente popular entre los desarrolladores. Para 2010, JSON había desplazado en gran medida a XML en las APIs web.

Tipos de datos JSON

JSON admite exactamente seis tipos de datos. Cada valor en un documento JSON válido debe ser uno de estos:

{
  "string":  "hello world",
  "number":  42,
  "float":   3.14,
  "boolean": true,
  "null":    null,
  "array":   [1, 2, 3],
  "object":  { "nested": "value" }
}

Reglas de sintaxis JSON

JSON tiene reglas de sintaxis estrictas. Una pequeña desviación causa un error de análisis. Estas son las seis reglas más importantes:

JSON inválido vs. válido

{
  'name': 'Alice',       // single quotes — invalid
  age: 30,              // unquoted key — invalid
  "scores": [1, 2, 3,], // trailing comma — invalid
  "note": undefined     // undefined — invalid
}

{
  "name": "Alice",
  "age": 30,
  "scores": [1, 2, 3],
  "note": null
}

JSON en la web moderna

APIs REST

JSON es el formato de cuerpo estándar para solicitudes y respuestas de API REST. Content-Type: application/json es el tipo MIME más común en la web moderna. Prácticamente todos los lenguajes de programación tienen un analizador JSON integrado.

Archivos de configuración

package.json, tsconfig.json, .eslintrc y muchas otras herramientas de desarrollo usan JSON para la configuración. El formato estructurado y el soporte universal de analizadores lo hacen práctico, aunque la falta de comentarios es una crítica persistente.

Bases de datos NoSQL

Las bases de datos de documentos como MongoDB, CouchDB y Amazon DynamoDB almacenan datos como documentos JSON o similares. Esto permite almacenamiento flexible sin esquema que se mapea naturalmente a los objetos de la aplicación.

Estado y datos del frontend

localStorage y sessionStorage almacenan cadenas, por lo que JSON.stringify/JSON.parse se usan constantemente para serializar objetos JavaScript. Las respuestas de API de fetch() llegan como texto JSON y se analizan antes de usarse.

JSON vs. otros formatos

JSON no siempre es la mejor opción. Así es como se compara con otros formatos de datos comunes:

JSON Schema

JSON Schema es un vocabulario para validar la estructura de documentos JSON. Un esquema describe los tipos esperados, los campos requeridos y las restricciones de un valor JSON. La versión actual es JSON Schema 2020-12.

Herramientas como ajv (JavaScript), jsonschema (Python) y validadores integrados en muchos IDEs admiten JSON Schema. OpenAPI usa JSON Schema para describir los cuerpos de solicitudes y respuestas de API.

Errores comunes con JSON

Preguntas frecuentes