调试 Express
若要查看 Express 中使用的所有内部日志,请在启动应用时将 DEBUG 环境变量设置为 express:*。
$ DEBUG=express:* node index.js在 Windows 系统上,请使用对应的命令。
> $env:DEBUG = "express:*"; node index.jsRunning this command on the default app generated by the express generator prints the following output:
$ 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随后向该应用发送请求时,你会看到 Express 代码中指定的日志:
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若仅查看来自路由实现的日志,请将 DEBUG 的值设置为 express:router。 同理,若仅查看来自应用实现的日志,请将 DEBUG 的值设置为 express:application,以此类推。
由 express 生成的应用
由 express 命令生成的应用会使用 debug 模块,且其调试命名空间的作用域限定为应用名称。
例如,如果你使用 $ express sample-app 命令生成了应用,可以通过以下命令启用调试语句:
$ DEBUG=sample-app:* node ./bin/www你可以通过指定以英文逗号分隔的名称列表,来启用多个调试命名空间:
$ DEBUG=http,mail,express:* node index.js高级选项
在通过 Node.js 运行时,你可以设置若干环境变量来更改调试日志的行为:
| Name | Purpose |
|---|---|
DEBUG | 启用或禁用特定的调试命名空间。 |
DEBUG_COLORS | 是否在调试输出中使用彩色显示。 |
DEBUG_DEPTH | 对象检查深度。 |
DEBUG_FD | 用于写入调试输出的文件描述符。 |
DEBUG_SHOW_HIDDEN | 显示被检查对象的隐藏属性。 |
Note
以 DEBUG_ 开头的环境变量最终会被转换为一个选项对象,供 %o/%O 格式化符使用。 See the Node.js documentation for
util.inspect() for the complete
list.