Trabajar con JSON

Si eres desarrollador, es probable que hayas oído hablar de JSON (notación de objetos JavaScript). ¡Está en todas partes! Desde API hasta archivos de configuración, JSON es el formato preferido para intercambiar datos. ¿Pero cómo trabajamos con él en Node.js? Analicémoslo en términos simples, con algunos ejemplos del mundo real que te ayudarán en el camino.

¿Qué es JSON?

En palabras simples, JSON es un formato para almacenar e intercambiar datos. Es fácil de leer y escribir, lo que lo hace muy popular para el desarrollo web. Se ve así:

{
  "name": "Alice",
  "age": 25,
  "city": "Wonderland"
}

Es básicamente una colección de pares clave-valor, como un objeto JavaScript. Pero recuerda: JSON es solo texto; debe convertirse en un objeto para que sea útil en tu código.

Analizando JSON en Node.js

Comencemos tomando una cadena JSON y convirtiéndola en algo con lo que podamos trabajar: un objeto JavaScript. Hacemos esto usando JSON.parse().

Ejemplo: análisis de JSON

const jsonString = '{"name": "Alice", "age": 25, "city": "Wonderland"}';
const jsonObject = JSON.parse(jsonString);

console.log(jsonObject.name); // Output: Alice

Esto toma una cadena JSON, la analiza y la convierte en un objeto JavaScript. Ahora puedes acceder a sus propiedades como nombre, edad o ciudad.

Convertir objetos a JSON

¿Qué pasa si necesitas enviar tus datos como JSON? Ahí es donde entra en juego JSON.stringify(). Toma su objeto JavaScript y lo convierte en una cadena JSON.

Ejemplo: convertir un objeto a JSON

const user = {
  name: "Alice",
  age: 25,
  city: "Wonderland"
};

const jsonString = JSON.stringify(user);
console.log(jsonString);
// Output: {"name":"Alice","age":25,"city":"Wonderland"}

Esto es muy útil cuando creas API o almacenas datos como JSON.

Lectura y escritura de archivos JSON en Node.js

¿Necesitas trabajar con archivos JSON? Node.js lo hace fácil con el módulo fs (Sistema de archivos). Puedes leer y escribir archivos JSON sin muchos problemas.

Ejemplo: leer un archivo JSON

const fs = require('fs');

fs.readFile('data.json', 'utf8', (err, data) => {
  if (err) {
    console.error(err);
    return;
  }
  const jsonData = JSON.parse(data);
  console.log(jsonData);
});

Aquí usamos fs.readFile() para leer el archivo JSON y luego analizamos el contenido del archivo en un objeto JavaScript. ¡Ahora puedes hacer lo que quieras con los datos!

Ejemplo: escribir en un archivo JSON

const fs = require('fs');

const user = {
  name: "Alice",
  age: 25,
  city: "Wonderland"
};

fs.writeFile('output.json', JSON.stringify(user, null, 2), (err) => {
  if (err) {
    console.error(err);
    return;
  }
  console.log('Data saved to output.json');
});

En este caso, JSON.stringify() convierte el objeto en una cadena JSON formateada y agradable, y fs.writeFile() lo guarda en un archivo. ¡Fácil!

Envío y recepción de JSON con solicitudes HTTP

Al crear API, JSON es el formato elegido para enviar y recibir datos. En Express.js, puedes enviar y recibir datos JSON sin esfuerzo.

Ejemplo: enviar JSON en una respuesta

const express = require('express');
const app = express();

app.get('/user', (req, res) => {
  const user = { name: "Alice", age: 25, city: "Wonderland" };
  res.json(user);
});

app.listen(3000, () => console.log('Server running on port 3000'));

Aquí, enviamos un objeto JSON como respuesta a una solicitud HTTP GET. ¡Es tan simple como llamar a res.json()!

Ejemplo: recibir JSON en una solicitud

app.use(express.json()); // Middleware to parse JSON body

app.post('/user', (req, res) => {
  const user = req.body;
  console.log(user); // Output: { name: "Alice", age: 25, city: "Wonderland" }
  res.send('User received!');
});

En este ejemplo, utilizamos el middleware express.json() para analizar automáticamente los datos JSON entrantes del cuerpo de la solicitud, convirtiéndolos en un objeto JavaScript que podemos usar.

Manejo de errores JSON

¿Qué pasa si obtienes datos JSON incorrectos? No te preocupes: Node.js tiene manejo de errores incorporado. Veamos cómo detectar esos errores.

Ejemplo: Manejo de errores de análisis

const faultyJson = '{"name": "Alice", "age": 25'; // Oops, missing closing bracket

try {
  const jsonObj = JSON.parse(faultyJson);
} catch (error) {
  console.error('Failed to parse JSON:', error.message);
}

Si el JSON no funciona, JSON.parse() arrojará un error. En este caso, el bloque try-catch nos ayuda a manejarlo con elegancia.

Concluyendo

JSON es algo que debes conocer si estás trabajando con datos en Node.js. Ya sea que esté analizando, creando, leyendo o enviando datos JSON, los métodos integrados en Node.js lo simplifican. Utilice JSON.parse() para convertir cadenas en objetos, JSON.stringify() para ir en sentido contrario y Express.js para un manejo fluido de JSON en su API.

Siéntete cómodo trabajando con JSON y tendrás una de las herramientas más valiosas en tu kit de herramientas de desarrollador.

Referencias:

1. Documentación de Node.js: Trabajar con JSON
2. Guía Express.js: Manejo de solicitudes JSON
3. Documentos web de MDN: JSON.parse()

¡Gracias por leer y feliz codificación! ?