JSON: El lenguaje común para el intercambio de datos

Al finalizar este tema

Podrás explicar qué es JSON, por qué se utiliza en lugar de XML o CSV, y conocerás los dos métodos para manipular JSON en JavaScript.

Los datos han llegado desde el servidor

Al realizar una llamada a la API, el servidor envía algo como esto:

{"name": "Alex", "age": 30, "skills": ["Python", "React"]}

Esto es JSON. ¿Le resulta familiar? Se parece mucho a un objeto de JavaScript. De hecho, es la abreviatura de JavaScript Object Notation.

Sin embargo, JSON no es exclusivo de JavaScript. Casi todos los lenguajes, ya sea Python, Java o Go, pueden leer y escribir JSON. Por eso es un "lenguaje común".

¿Por qué JSON se impuso?

Existen otros formatos para el intercambio de datos además de JSON.

XML — Utiliza etiquetas para envolver el contenido, de forma similar a HTML:

<user>
  <name>Alex</name>
  <age>30</age>
</user>

Funciona. Pero fíjense: la palabra name aparece tres veces. Entre abrir y cerrar etiquetas, hay más envoltura que datos. El archivo aumenta de tamaño y resulta tedioso de leer.

CSV — formato tabular separado por comas:

name,age
Alex,30
Jordan,25

Es ligero y tiene buena compatibilidad con Excel. Sin embargo, no puede representar datos anidados como "Python, React dentro de skills". Su límite es una tabla bidimensional.

JSON ha tomado solo las ventajas de ambos:

• Permite anidamiento como XML (un array dentro de un objeto, un objeto dentro de un array)
• Es ligero como CSV (sin etiquetas, clave: valor)
• Es legible para los humanos de forma inmediata

Por ello, se ha convertido en el estándar de facto para las APIs web desde la década de 2010.

Las cuatro reglas de JSON

JSON parece flexible, pero sus reglas son estrictas. Si falla una sola, se producirá un error de análisis (parsing).

{
  "name": "Alex",
  "age": 30,
  "isAdmin": false,
  "skills": ["Python", "React"],
  "address": null
}

1. Las cadenas de texto deben usar siempre comillas dobles " — el uso de comillas simples ' provocará un error.
2. Las claves también deben usar comillas dobles — no es obligatorio en objetos JavaScript, pero es indispensable en JSON.
3. No se permite la coma después del último elemento — escribirlo como "React"], provocará un error (es un error muy común).
4. Valores permitidos: cadenas de texto, números, booleanos (true/false), null, arreglos y objetos — las funciones no están permitidas.

Manipulación en JavaScript

Solo existen dos métodos para manipular JSON:

// Objeto → cadena JSON (al enviarlo al servidor)
const str = JSON.stringify({ name: "Alex", age: 30 });
// '{"name":"Alex","age":30}'

// Cadena JSON → objeto (al recibirla del servidor)
const obj = JSON.parse(str);
console.log(obj.name);  // "Alex"

stringify puede entenderse como el empaquetado y parse como el desempaquetado. Se empaqueta al enviar al servidor y se desempaqueta al recibirlo.

¿Dónde se utiliza?

JSON se utiliza en muchísimos lugares, no solo en la comunicación mediante API:

• package.json — archivo de configuración de proyectos Node.js
• tsconfig.json — configuración de TypeScript
• Configuración de VS Code — toda la configuración del editor es JSON
• localStorage del navegador — almacenamiento del lado del cliente
• Firebase — su base de datos en tiempo real se basa en JSON

Es casi imposible pasar un día desarrollando sin encontrarse con JSON.

Errores comunes

La mayoría de los errores de JSON se deben a una de estas tres causas:

{
  "name": 'Alex',           // ❌ Comillas simples — solo se permiten comillas dobles
  "age": 30,
  "skills": ["Python",],    // ❌ Coma final — válida en JavaScript, pero no en JSON
  name: "Alex"              // ❌ Clave sin comillas — válida en JavaScript, pero no en JSON
}

Si ya está familiarizado con la sintaxis de los objetos de JavaScript, es más probable que cometa errores. JSON es más estricto que los objetos de JavaScript. Si se pregunta "¿por qué aparece un error de análisis de repente?", verifique primero estos tres puntos.

Tenga en cuenta que no se pueden incluir comentarios en JSON. Ni // ni /* */ son válidos. Si desea agregar explicaciones a un archivo de configuración, puede usar YAML o utilizar convencionalmente claves como "_comment". Aunque existen herramientas que admiten JSONC (JSON con comentarios) como tsconfig.json, el estándar JSON no permite comentarios.

Puntos clave

JSON es un estándar de empaquetado común para el intercambio de datos entre programas. Las comillas dobles son obligatorias y la coma final está prohibida; si recuerda estas dos reglas, podrá evitar el 80 % de los errores de análisis. Todo se reduce a estos dos métodos: JSON.stringify (empaquetado) y JSON.parse (desempaquetado).