La librería Boom es una herramienta de gran utilidad para manejar errores en aplicaciones Node.js. Al respetar los status codes HTTP, hace que nuestros errores sean más descriptivos y compatibles con las convenciones estándar. La instalación es sencilla, usando el paquete @hapi/boom. Una vez instalada, se integra fácilmente en nuestros servicios para comenzar a manipular los errores de manera efectiva. Esto mejora significativamente la interacción con los clientes, ya que reciben mensajes de error más claros y precisos.
¿Cómo se integra Boom en un servicio?
Para comenzar a utilizar Boom en un servicio, primero se debe importar la dependencia en nuestro archivo de servicio. Una vez importada, podemos manejar los errores de forma más eficiente, asociando el error a un status code adecuado.
constBoom=require('@hapi/boom');// Ejemplo de uso en una actualización de productoif(!productoEncontrado){throwBoom.notFound('Product not found');}
Este código asegura que si un producto no se encuentra, se enviará un error 404 automatizado, mucho más intuitivo para quien desarrolle o mantenga la aplicación.
¿Cómo crear un middleware para manejar errores con Boom?
Crear un middleware que identifique y maneje errores de Boom es esencial para un manejo adecuado:
Identificación de errores Boom: Se verifica si el error tiene la propiedad isBoom. Si es así, el middleware se encarga del formateo correspondiente.
Manipulación del output: La información necesaria, como el status code y el payload del error, se extrae del error.output.
En este ejemplo, si el error es de tipo Boom, se maneja y responde adecuadamente, previniendo que se unan a la cadena de middleware regular.
¿Cómo mejorar la lógica de negocio usando Boom?
Podemos aplicar Boom para implementar reglas de negocio más complejas, como bloquear ciertos productos basados en criterios específicos:
Introducción de lógica de negocio: Supongamos que ciertos productos no deben mostrarse. Utilizamos la propiedad isBlock determinarás si el producto está bloqueado:
const isBlocked = faker.datatype.boolean();if(isBlocked){throwBoom.conflict('Product is blocked');}
Prueba del middleware y la lógica: Tras implementar las reglas, pruebas periódicas aseguran la respuesta correcta para varios escenarios, desde productos encontrados hasta bloqueos por razones de negocio.
Error handling mejorado: Las respuestas se dividen entre los diferentes escenarios de error (404 Not Found, 409 Conflict, etc.), mejorando la experiencia del usuario final.
¿Cómo solucionar problemas comunes al implementar Boom?
Un problema típico al configurar Boom es que los headers no pueden ser ajustados después de haber sido enviados. Para evitarlo, asegúrate de que, al manejar los errores, el flujo se detiene antes de pasar al siguiente middleware:
// Corrección del flujo en la gestión de erroresif(err.isBoom){const{ output }= err; res.status(output.statusCode).json(output.payload);}else{next(err);}
Con esta corrección, los errores se despachan correctamente, respetando el flujo de middleware de Node.js, evitando los errores comunes de múltiples configuraciones de headers.
Al implementar Boom correctamente, nuestra aplicación no solo es más robusta, sino que también ofrece feedback mucho más informativo y claro a los usuarios. Estas mejoras simplifican diagnósticos y mantenimiento, y animan a explorar más herramientas que fortalezcan las funcionalidades de nuestras aplicaciones.
La librería Boom es una herramienta de gran utilidad para manejar errores en aplicaciones Node.js. Al respetar los status codes HTTP, hace que nuestros errores sean más descriptivos y compatibles con las convenciones estándar. La instalación es sencilla, usando el paquete @hapi/boom. Una vez instalada, se integra fácilmente en nuestros servicios para comenzar a manipular los errores de manera efectiva. Esto mejora significativamente la interacción con los clientes, ya que reciben mensajes de error más claros y precisos.
¿Cómo se integra Boom en un servicio?
Para comenzar a utilizar Boom en un servicio, primero se debe importar la dependencia en nuestro archivo de servicio. Una vez importada, podemos manejar los errores de forma más eficiente, asociando el error a un status code adecuado.
const Boom = require('@hapi/boom');
// Ejemplo de uso en una actualización de producto
if (!productoEncontrado) {
throw Boom.notFound('Product not found');
}
Este código asegura que si un producto no se encuentra, se enviará un error 404 automatizado, mucho más intuitivo para quien desarrolle o mantenga la aplicación.
¿Cómo crear un middleware para manejar errores con Boom?
Crear un middleware que identifique y maneje errores de Boom es esencial para un manejo adecuado:
Identificación de errores Boom: Se verifica si el error tiene la propiedad isBoom. Si es así, el middleware se encarga del formateo correspondiente.
Manipulación del output: La información necesaria, como el status code y el payload del error, se extrae del error.output.
En este ejemplo, si el error es de tipo Boom, se maneja y responde adecuadamente, previniendo que se unan a la cadena de middleware regular.
¿Cómo mejorar la lógica de negocio usando Boom?
Podemos aplicar Boom para implementar reglas de negocio más complejas, como bloquear ciertos productos basados en criterios específicos:
Introducción de lógica de negocio: Supongamos que ciertos productos no deben mostrarse. Utilizamos la propiedad isBlock determinarás si el producto está bloqueado:
const isBlocked = faker.datatype.boolean();
if (isBlocked) {
throw Boom.conflict('Product is blocked');
}
Prueba del middleware y la lógica: Tras implementar las reglas, pruebas periódicas aseguran la respuesta correcta para varios escenarios, desde productos encontrados hasta bloqueos por razones de negocio.
Error handling mejorado: Las respuestas se dividen entre los diferentes escenarios de error (404 Not Found, 409 Conflict, etc.), mejorando la experiencia del usuario final.
¿Cómo solucionar problemas comunes al implementar Boom?
Un problema típico al configurar Boom es que los headers no pueden ser ajustados después de haber sido enviados. Para evitarlo, asegúrate de que, al manejar los errores, el flujo se detiene antes de pasar al siguiente middleware:
// Corrección del flujo en la gestión de errores
if (err.isBoom) {
const { output } = err;
res.status(output.statusCode).json(output.payload);
} else {
next(err);
}
Con esta corrección, los errores se despachan correctamente, respetando el flujo de middleware de Node.js, evitando los errores comunes de múltiples configuraciones de headers.
Al implementar Boom correctamente, nuestra aplicación no solo es más robusta, sino que también ofrece feedback mucho más informativo y claro a los usuarios. Estas mejoras simplifican diagnósticos y mantenimiento, y animan a explorar más herramientas que fortalezcan las funcionalidades de nuestras aplicaciones.
De acuerdo a lo que he visto en los cursos de node hay que tener en cuenta que TODO puede fallar, es la razón por la cual se trabaja tanto el tema de aprender a manejar y capturar errores, dado que por como funciona Node si un error no es capturado detendrá toda la aplicación.
Así implemente el error para la función de Update:
async update(id, changes) {
const index = this.products.findIndex(item => item.id === id);
if (index === -1){
throw boom.notFound("Product not found");
}
const product = this.products[index];
if (product.isBlock){
throw boom.conflict("Product is Block");
}
this.products[index] = {
...product,
...changes
};
return this.products[index];
};
Para los que usamos WSL, me empezó a dar un error de conexión ya que no conectaba postman o insomnia con la API en su puerto. Tampoco podía verla en navegador.
Lo resolví ejecutando en la terminal PowerShell de windows:
wsl --shutdown
Esto reinicia los servicios del WSL y pude terminar el proyecto.
Me pase alrededor de 3 dias tratando de solucionar el error status code 404 que no me salia y lo estaba revisando en el update, y no en el patch (partial update) y ya tenia bien mi codigo, xD
Un pequeño consejo para todos, tengan cuidado donde ponen su funcion de routerApi(app) en el index principal debido a que si lo ponen mal les ocasionara problemas con el manejo de errores, lo descubrí a base de experiencia y 1 hora de busqueda de error :')
Creo que es mejor que Boom sea usado del lado del router. Si nos vamos a lo estricto de Clean Architecture, boom hace manejo de errores a nivel web, y los Servicios estan mas orientados al negocio. Con lanzar el error en el Service, capturarlo en el router, y ahi si lanzar el error por medio de Boom, estaría bien.
De acuerdo a lo que he visto en los cursos de node hay que tener en cuenta que TODO puede fallar, es la razón por la cual se trabaja tanto el tema de aprender a manejar y capturar errores, dado que por como funciona Node si un error no es capturado detendrá toda la aplicación.
Así implemente el error para la función de Update:
asyncupdate(id, changes){const index =this.products.findIndex(item=> item.id=== id);if(index ===-1){throw boom.notFound("Product not found");}const product =this.products[index];if(product.isBlock){throw boom.conflict("Product is Block");}this.products[index]={...product,...changes
};returnthis.products[index];};
Comando para instalar la libreria de boom
npm i @hapi/boom
Debido a que en clases pasadas se vio como manejar los métodos de los servicios con asincronía me topé con algunas cosas que quiero compartir.
Básicamente es que cuando el método regresa una promesa
returnnewPromise((resolve, reject)=>{...});
el boom.notFound() va dentro de la función reject().
En caso de que el método no regrese una promesa, se puede hacer uso del throw y el return como se ve en la clase.
service.js
router.js
middleware.js
Muchas gracias, tu idea me sirvio para construir una logica y simular un error tipo 500 al pedir todos los productos reject
Recuerda que el async no es necesario si NO estas utilizando await. En tu método "getOne" de la clase "service" definitivamente sobra, ya estas manejando el asincronismo con promise.
cada clase de este curso es oro
Para los que usamos WSL, me empezó a dar un error de conexión ya que no conectaba postman o insomnia con la API en su puerto. Tampoco podía verla en navegador.
Lo resolví ejecutando en la terminal PowerShell de windows:
wsl --shutdown
Esto reinicia los servicios del WSL y pude terminar el proyecto.
Justo esto me sucedió varias veces en el pasado, y me tomo mucho en conseguir ese comando la primera vez.
Gracias por el aporte :D
Me pase alrededor de 3 dias tratando de solucionar el error status code 404 que no me salia y lo estaba revisando en el update, y no en el patch (partial update) y ya tenia bien mi codigo, xD
😅
este man sabe mucho
Un pequeño consejo para todos, tengan cuidado donde ponen su funcion de routerApi(app) en el index principal debido a que si lo ponen mal les ocasionara problemas con el manejo de errores, lo descubrí a base de experiencia y 1 hora de busqueda de error :')
Oye muchas gracias. muy bueno tu aporte
OMG me has salvado la vida, muchas gracias
Creo que es mejor que Boom sea usado del lado del router. Si nos vamos a lo estricto de Clean Architecture, boom hace manejo de errores a nivel web, y los Servicios estan mas orientados al negocio. Con lanzar el error en el Service, capturarlo en el router, y ahi si lanzar el error por medio de Boom, estaría bien.
Opino exactamente lo mismo, estaba buscando un comentario así.
🧐 En la documentación, aquí encuentran todos los métodos para los errores:
HTTP 4xx Errors
HTTP 5xx Errors
npm i @hapi/boom
En los archivos del curso no se encuentra actualizado el archivo error.hanlder.js
Estuve un rato viendo mi codigo para ver si habia escrito algo mal, no encontraba el error le di click al error y me mando a un archivo dentro de node_modules. Ahi estaba el error de sintaxis.
No supe como corregirlo asi que use mi camino facil.
Desinstale boom
<npm unistall @hapi/boom >
e instale la misme versio que usa Nico
< npm i @hapi/boom@9.1.4>
no se si fue la mejor forma de solucionarlo pero y jalo
Gracias!!! ya tenia unas cuantas horas con lo mismo
Porque me tira la aplicación y me da un error en una línea que no tiene nada que ver, con mensaje, sin mensaje, hasta con data que según la documentación es opcional
La solucion es que retrocedas la version de boom, yo lo hice asi:
npm i @hapi/boom@9.1.4
Es la versión que esta en el curso
@rommel.alberto no, esa no es la solución, me faltaba un next. Pueden usar la última versión sin problemas.
¿Qué es la lógica de negocio?
La lógica de negocio es la que determinan como funciona el programa, los servicios a cumplir, e independiente del modelo, que prácticamente es la gestión de la base de datos desde la aplicación, las vistas, que es la interfaz gráfica con la que interactúan los usuarios, y los controladores los cuales establecen las rutas, validaciones, seguridad e infraestructura de la aplicación.
A lo que nos lleva que en la lógica negocio encontramos solo algoritmos y procesos que hacen que nuestra aplicación sea única y diferente al resto de las existentes.
Por mi lado también estoy recibiendo el error
Error [ERR_HTTP_HEADERS_SENT]: Cannot set headers after they are sent to the client
at new NodeError (node:internal/errors:371:5)
at ServerResponse.setHeader (node:_http_outgoing:576:11)
En archivo "productos.routes.js" al trazar la caída, puedo ver que se esta saliendo por el el Catch:
supongo que ya lo habrás solucionado, pero para quien no, yo lo solucione metiendo el next(err) dentro de un else en la función boom, quedando de la siguiente manera:
¿Cómo sabemos a cuál middleware de tipo error irá?
O no es necesario controlar la secuencia del flujo de ejecución?
Por eso al momento de llamar esos middlewares primero llamas al de boom que comprueba si es error de tipo boom o no, si no es boom deja pasar al otro middleware que llamas despues
Creo que boom se encarga de eso, tu solo tienes que poner el tipo de error que consideres para cada uno en tus services, como el profe lo hizo:
findOne(id){const product =this.products.find((product)=> product.id=== id);if(!product){throw boom.notFound('product not found');}
El boom.notFound("mensaje") le dice a boom que es error de tipo 404.
.
Aquí puedes ver todos los tipos de errores que maneja boom