express 4.x.x 文档翻译

Posted 2022-11-23 viana37

持续更新，一边学习一边翻译整理。

app.use([path,] function [, function…])

执行指定路径上的 中间件。path 参数默认为“/”。

路由将会匹配所有包含[path]参数的路径。如：app.use('/apple',...)会匹配"/apple","/apple/images","/apple/images/news"等。

注意，中间件的 req.originalUrl 参数是和 req.baseUrl 、* req.path* 配合使用的，示例如下：

app.use('/admin', function(req, res, next) 
  // GET 'http://www.example.com/admin/new'
  console.log(req.originalUrl);   // '/admin/new'
  console.log(req.baseUrl);      // '/admin'
  console.log(req.path);         // '/new'
  next();
);

将一个中间件跟路径对应之后，如果路径匹配，则处理HTTP请求时会执行该中间件。
由于路径默认为“/”，则不设置 path 的中间件在每一次HTTP请求中都会被执行。

//在每次HTTP请求下都会打印一次服务器日期
app.use(function (req, res, next) 
  console.log('Time: %d', Date.now());
  next();
);

注意：对于sub-app
- 如果有默认值则不会继承设置的值。你必须在 sub-app中重新设置。
- 如果没有默认值，则会继承。
更多细节，请参考Application setting.
中间件是按序执行的，因此在代码中务必注意出现的顺序。

// 这个中间件将会阻止请求向后执行
app.use(function(req, res, next) 
  res.send('Hello World');
);

// 请求将永远不会执行到这里
app.get('/', function (req, res) 
  res.send('Welcome');
);

path 参数可以是一个字符串，一个变量，一个正则表达式或一个数组。原始文档中有很多例子，我使用Markdown不好复制。大家可以戳这里去看。
function 参数可以是一个中间件，可以是一系列中间件(以逗号分隔)，可以是一个数组，也可以是他们的组合。router 和app 实现了中间件的接口，你也可以直接使用他们作为function 。
(例子表格待补充)