Express在内部使用调试模块来记录有关路由匹配,正在使用的中间件功能,应用程序模式以及请求-响应周期流程的信息。

debug就像是的增强版console.log,但与不同console.log,您不必注释debug生产代码中的日志。默认情况下,日志记录是关闭的,可以使用DEBUG环境变量有条件地将其打开。

要查看Express中使用的所有内部日志,请在启动应用程序时将DEBUG环境变量 设置为express:*

  1. $ DEBUG=express:* node index.js

在Windows上,使用相应的命令。

  1. > set DEBUG=express:* & node index.js

express生成器生成的默认应用程序上运行此命令将打印以下输出:

  1. $ DEBUG=express:* node ./bin/www
  2. express:router:route new / +0ms
  3. express:router:layer new / +1ms
  4. express:router:route get / +1ms
  5. express:router:layer new / +0ms
  6. express:router:route new / +1ms
  7. express:router:layer new / +0ms
  8. express:router:route get / +0ms
  9. express:router:layer new / +0ms
  10. express:application compile etag weak +1ms
  11. express:application compile query parser extended +0ms
  12. express:application compile trust proxy false +0ms
  13. express:application booting in development mode +1ms
  14. express:router use / query +0ms
  15. express:router:layer new / +0ms
  16. express:router use / expressInit +0ms
  17. express:router:layer new / +0ms
  18. express:router use / favicon +1ms
  19. express:router:layer new / +0ms
  20. express:router use / logger +0ms
  21. express:router:layer new / +0ms
  22. express:router use / jsonParser +0ms
  23. express:router:layer new / +1ms
  24. express:router use / urlencodedParser +0ms
  25. express:router:layer new / +0ms
  26. express:router use / cookieParser +0ms
  27. express:router:layer new / +0ms
  28. express:router use / stylus +90ms
  29. express:router:layer new / +0ms
  30. express:router use / serveStatic +0ms
  31. express:router:layer new / +0ms
  32. express:router use / router +0ms
  33. express:router:layer new / +1ms
  34. express:router use /users router +0ms
  35. express:router:layer new /users +0ms
  36. express:router use / <anonymous> +0ms
  37. express:router:layer new / +0ms
  38. express:router use / <anonymous> +0ms
  39. express:router:layer new / +0ms
  40. express:router use / <anonymous> +0ms
  41. express:router:layer new / +0ms

然后向应用程序发出请求时,您将看到Express代码中指定的日志:

  1. express:router dispatching GET / +4h
  2. express:router query : / +2ms
  3. express:router expressInit : / +0ms
  4. express:router favicon : / +0ms
  5. express:router logger : / +1ms
  6. express:router jsonParser : / +0ms
  7. express:router urlencodedParser : / +1ms
  8. express:router cookieParser : / +0ms
  9. express:router stylus : / +0ms
  10. express:router serveStatic : / +2ms
  11. express:router router : / +2ms
  12. express:router dispatching GET / +1ms
  13. express:view lookup "index.pug" +338ms
  14. express:view stat "/projects/example/views/index.pug" +0ms
  15. express:view render "/projects/example/views/index.pug" +1ms

要仅查看来自路由器实现的日志,请将的值设置DEBUGexpress:router。同样,要仅查看来自应用程序实现的日志,请将的值设置DEBUGexpress:application,依此类推。

产生的应用程式 express

express命令生成的应用程序也使用该debug模块,并且其调试名称空间的作用域为该应用程序的名称。
例如,如果使用生成了应用程序$ express sample-app,则可以使用以下命令启用调试语句:

  1. $ DEBUG=sample-app:* node ./bin/www

您可以通过分配以逗号分隔的名称列表来指定多个调试名称空间:

  1. $ DEBUG=http,mail,express:* node index.js

高级选项

通过Node.js运行时,可以设置一些环境变量,这些变量将更改调试日志记录的行为:

名称 目的
DEBUG 启用/禁用特定的调试名称空间。
DEBUG_COLORS 在调试输出中是否使用颜色。
DEBUG_DEPTH 物体检查深度。
DEBUG_FD 要写入调试输出的文件描述符。
DEBUG_SHOW_HIDDEN 显示检查对象的隐藏属性。

注意:以开头的环境变量DEBUG_最终将转换为与%o/ %O格式化程序一起使用的Options对象。有关util.inspect() 完整列表,请参见Node.js文档 。

资源资源

有关更多信息debug,请参见调试