非常教程

Express参考手册

指南 | Guide

6.调试Express | 6. Debugging Express

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

debug就像增强版本console.log,但不像console.log你不必编写debug代码中注释日志。日志记录默认情况下处于关闭状态,可以通过使用DEBUG环境变量有条件地启用。

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

$ DEBUG=express:* node index.js

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

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

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

$ 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

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

Express

Express 是一个简洁而灵活的 node.js Web 应用框架, 提供一系列强大特性帮助你创建各种 Web 应用。Express 不对 node.js 已有的特性进行二次抽象,只是在它之上扩展了 Web 应用所需的功能。丰富的 HTTP 工具以及来自 Connect 框架的中间件随取随用,创建强健、友好的 API 变得快速又简单。

主页 http://expressjs.com/
源码 https://github.com/strongloop/express/
发布版本 4.16.1

Express目录

1.开始 | Getting started
2.指南 | Guide
3.高级主题 | Advanced topics
4.API