10.8. Creación de una API REST básica con NodeJS y ExpressJS: manejo de errores

10.8. Creación de una API REST básica con NodeJS y ExpressJS: manejo de errores

NodeJS y ExpressJS son dos herramientas potentes que puedes utilizar para crear API REST. Una API REST, o transferencia de estado representacional, es un estilo de arquitectura de software que utiliza un conjunto de protocolos y estándares para crear aplicaciones web. En esta sección, aprenderemos cómo crear una API REST básica con NodeJS y ExpressJS y cómo manejar errores.

Configuración del entorno

Antes de comenzar, debemos asegurarnos de tener NodeJS y npm (Node Package Manager) instalados en nuestro sistema. Si aún no los tienes, puedes descargarlos desde el sitio web oficial de NodeJS. Después de la instalación, puedes verificar que estén instalados correctamente ejecutando los siguientes comandos en la terminal:

$ nodo -v
$npm-v

A continuación, necesitamos instalar ExpressJS, que es un marco web para NodeJS. Puede instalar ExpressJS usando npm con el siguiente comando:

$ npm instalar expreso

Creando la API REST

Primero, creemos un nuevo archivo llamado 'app.js'. Este será nuestro archivo principal donde configuraremos nuestra API REST. En el archivo 'app.js', comencemos importando ExpressJS:

const expresar = requerir('expresar');

A continuación, creemos una nueva instancia de Express:

aplicación constante = expresar();

Ahora, definamos algunas rutas para nuestra API. Por ejemplo, creemos una ruta GET a '/usuarios' que devuelva una lista de usuarios:

app.get('/usuarios', (req, res) => {
  res.json({ usuarios: ['John', 'Jane', 'Bob'] });
});

Finalmente, hagamos que nuestra aplicación escuche el puerto 3000:

aplicación.escuchar(3000, () => {
  console.log('El servidor se está ejecutando en el puerto 3000');
});

Manejo de errores

El manejo de errores es una parte crucial de cualquier aplicación. En ExpressJS, puede manejar errores utilizando middleware de errores. Un middleware de error es una función que toma cuatro argumentos: (err, req, res, next).

Puede definir un middleware de error de la siguiente manera:

aplicación.use((err, req, res, siguiente) => {
  consola.error(err.pila);
  res.status(500).send('¡Algo se rompió!');
});

Este middleware de errores detectará cualquier error que ocurra en la aplicación y registrará la pila de errores en la consola y luego enviará una respuesta con el estado 500 y el mensaje "¡Algo se rompió!".

Es importante tener en cuenta que el middleware de error debe definirse después de todas las demás rutas y middleware, porque solo detectará los errores que se produzcan en el middleware y las rutas definidas antes.

Además, puede crear middleware de errores personalizado para manejar diferentes tipos de errores de diferentes maneras. Por ejemplo, puede crear un middleware de errores para manejar los errores de validación y otro para manejar los errores de autenticación.

Conclusión

En este capítulo, aprendimos cómo crear una API REST básica con NodeJS y ExpressJS y cómo manejar errores. ExpressJS facilita la creación de API REST y ofrece muchas funciones útiles, como middleware de errores, que nos permiten manejar los errores de forma eficaz.

En el siguiente capítulo, aprenderemos cómo agregar autenticación a nuestra API y cómo proteger nuestras rutas con JWT (JSON Web Tokens).

Siguiente página del libro electrónico gratuito:

74Creación de una API REST básica con NodeJS y ExpressJS: autenticación y autorización

4 minutos