Editar en GitHub

Depuración de Express

Para ver todos los logs internos utilizados en Express, establece la variable de entorno DEBUG a express:* al iniciar tu aplicación.

Ventana de terminal
$ DEBUG=express:* node index.js

En Windows, usa el comando correspondiente.

Ventana de terminal
> $env:DEBUG = "express:*"; node index.js

Ejecutar este comando en la aplicación por defecto generada por el express generator imprime la siguiente salida:

Ventana de terminal
$ DEBUG=express:* node ./bin/www
express:router:route new / +0ms
express:router:layer new / +1ms
express:router:route get / +1ms
express:router:layer new / +0ms
express:router:route new / +1ms
express:router:layer new / +0ms
express:router:route get / +0ms
express:router:layer new / +0ms
express:application compile etag weak +1ms
express:application compile query parser extended +0ms
express:application compile trust proxy false +0ms
express:application booting in development mode +1ms
express:router use / query +0ms
express:router:layer new / +0ms
express:router use / expressInit +0ms
express:router:layer new / +0ms
express:router use / favicon +1ms
express:router:layer new / +0ms
express:router use / logger +0ms
express:router:layer new / +0ms
express:router use / jsonParser +0ms
express:router:layer new / +1ms
express:router use / urlencodedParser +0ms
express:router:layer new / +0ms
express:router use / cookieParser +0ms
express:router:layer new / +0ms
express:router use / stylus +90ms
express:router:layer new / +0ms
express:router use / serveStatic +0ms
express:router:layer new / +0ms
express:router use / router +0ms
express:router:layer new / +1ms
express:router use /users router +0ms
express:router:layer new /users +0ms
express:router use / <anonymous> +0ms
express:router:layer new / +0ms
express:router use / <anonymous> +0ms
express:router:layer new / +0ms
express:router use / <anonymous> +0ms
express:router:layer new / +0ms

Cuando se realiza una solicitud a la aplicación, verás los logs especificados en el código de Express:

Ventana de terminal
express:router dispatching GET / +4h
express:router query : / +2ms
express:router expressInit : / +0ms
express:router favicon : / +0ms
express:router logger : / +1ms
express:router jsonParser : / +0ms
express:router urlencodedParser : / +1ms
express:router cookieParser : / +0ms
express:router stylus : / +0ms
express:router serveStatic : / +2ms
express:router router : / +2ms
express:router dispatching GET / +1ms
express:view lookup "index.pug" +338ms
express:view stat "/projects/example/views/index.pug" +0ms
express:view render "/projects/example/views/index.pug" +1ms

Para ver solo los logs de la implementación del router, establece el valor de DEBUG a express:router. Del mismo modo, para ver solo los logs de la implementación de la aplicación, establece el valor de DEBUG a express:application, y así sucesivamente.

Aplicaciones generadas por express

Una aplicación generada por el comando express utiliza el módulo debug y su espacio de nombres de depuración está limitado al nombre de la aplicación.

Por ejemplo, si generaste la aplicación con $ express sample-app, puedes habilitar las sentencias de depuración con el siguiente comando:

Ventana de terminal
$ DEBUG=sample-app:* node ./bin/www

Puedes especificar más de un espacio de nombres de depuración asignando una lista de nombres separados por comas:

Ventana de terminal
$ DEBUG=http,mail,express:* node index.js

Opciones avanzadas

Al ejecutar a través de Node.js, puedes establecer varias variables de entorno que cambiarán el comportamiento del registro de depuración:

NombrePropósito
DEBUGHabilita/deshabilita espacios de nombres de depuración específicos.
DEBUG_COLORSSi se usan o no colores en la salida de depuración.
DEBUG_DEPTHProfundidad de inspección de objetos.
DEBUG_FDDescriptor de archivo donde escribir la salida de depuración.
DEBUG_SHOW_HIDDENMuestra propiedades ocultas en los objetos inspeccionados.

Nota

Las variables de entorno que comienzan con DEBUG_ terminan siendo convertidas en un objeto Options que se utiliza con los formateadores %o/%O. Consulta la documentación de Node.js para util.inspect() para ver la lista completa.