Una herramienta de depuración para Python en la que ic() reemplaza a print() y muestra los nombres de variables, las expresiones y sus valores con formato legible y resaltado de sintaxis.
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
Instala el paquete con npm
npm install debug - 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
Script de Bash compatible con POSIX para instalar y alternar entre varias versiones de Node.js por usuario y por shell.
Un gestor de versiones de Node.js para Windows que instala y permite cambiar entre varias versiones por proyecto o de forma global.
Un framework de pruebas de JavaScript muy usado para Node.js y el navegador, con una estructura de pruebas al estilo describe/it y soporte para pruebas asíncronas.
Herramienta visual y de línea de comandos para probar y depurar servidores Model Context Protocol (MCP), con modos web, CLI e interfaz de terminal.
Componente de PHP que ofrece una función dump() mejorada para inspeccionar variables arbitrarias, como alternativa a var_dump().