Repolode
debug-js

debug-js/debug

Una pequeña utilidad de depuración para JavaScript que imprime mensajes con espacios de nombres en Node.js y navegadores, activados mediante la variable de entorno DEBUG.

Estrellas
11,458
Forks
998
Issues abiertos
98
Último commit
hace 11 días

¿Qué es?

debug es una pequeña utilidad de logging para JavaScript, basada en la técnica de depuración que se usa en el núcleo de Node.js. Permite crear una función de depuración con nombre y un espacio de nombres, como 'http' o 'worker:a'. Los mensajes solo se imprimen cuando el espacio de nombres está habilitado mediante la variable de entorno DEBUG. Los comodines y las exclusiones, como DEBUG=connect:* o DEBUG=*,-connect:*, permiten limitar los mensajes a partes específicas de una aplicación.

La biblioteca funciona tanto en Node.js como en navegadores web. En Node.js escribe en stderr, admite colores por espacio de nombres y muestra las diferencias de tiempo en milisegundos entre llamadas. En navegadores, el estado de activación se guarda en localStorage. Usa formatos al estilo de printf, como %o, %O, %s, %d y %j, y permite añadir formatos personalizados extendiendo debug.formatters.

También ofrece APIs para ampliar los espacios de nombres, comprobar si uno está habilitado y activar o desactivar los mensajes durante la ejecución.

Funciones clave

  • 01Funciones de depuración con espacios de nombres, activadas mediante la variable de entorno DEBUG.
  • 02Patrones de comodines y exclusión para filtrar los mensajes.
  • 03Funciona en Node.js y navegadores web, con colores cuando son compatibles.
  • 04Diferencia de tiempo en milisegundos entre llamadas, o marcas de tiempo ISO cuando la salida no es un TTY.
  • 05Formatos al estilo de printf, con compatibilidad para formatos personalizados.
  • 06APIs para activar, desactivar y ampliar espacios de nombres durante la ejecución.

Casos de uso

  • Añadir logs de depuración que se puedan activar a una biblioteca o aplicación de Node.js sin generar ruido de forma predeterminada.
  • Seguir el procesamiento de solicitudes o la actividad de workers en un proceso de servidor mediante espacios de nombres.
  • Depurar código frontend en el navegador configurando localStorage.debug.

Inicio rápido

  1. 1

    Instala el paquete con npm

    npm install debug
  2. 2

    Crea una instancia de debug en tu código con un espacio de nombres y, después, ejecuta la aplicación con DEBUG activado (macOS/Linux)

    DEBUG=* node app.js

Antes de usarlo

  • La salida de Debug solo se muestra para los espacios de nombres activados mediante la variable de entorno DEBUG o localStorage.debug.
  • En Node.js, para disponer de toda la paleta de colores se necesita el módulo opcional supports-color.

En colecciones

Temas

Preguntas frecuentes

¿Qué es debug?
Una pequeña utilidad de depuración para JavaScript que imprime mensajes con espacios de nombres en Node.js y navegadores, activados mediante la variable de entorno DEBUG. debug es una pequeña utilidad de logging para JavaScript, basada en la técnica de depuración que se usa en el núcleo de Node.js. Permite crear una función de depuración con nombre y un espacio de nombres, como 'http' o 'worker:a'. Los mensajes solo se imprimen cuando el espacio de nombres está habilitado mediante la variable de entorno DEBUG. Los comodines y las exclusiones, como DEBUG=connect:* o DEBUG=*,-connect:*, permiten limitar los mensajes a partes específicas de una aplicación.
¿debug es gratuito? ¿Qué licencia tiene?
debug es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿debug sigue mantenido?
Mantenimiento activo. El último commit de debug fue el 14 oct 2026.
¿Para qué puedo usar debug?
Añadir logs de depuración que se puedan activar a una biblioteca o aplicación de Node.js sin generar ruido de forma predeterminada. Seguir el procesamiento de solicitudes o la actividad de workers en un proceso de servidor mediante espacios de nombres. Depurar código frontend en el navegador configurando localStorage.debug.
¿Cómo se instala debug?
Instala el paquete con npm: npm install debug Crea una instancia de debug en tu código con un espacio de nombres y, después, ejecuta la aplicación con DEBUG activado (macOS/Linux): DEBUG=* node app.js
¿Dónde consigo debug?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/debug-js/debug

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados