这个翻译StrongLoop / IBM提供.

相对于英文版的文档,本文档可能已过时。要了解最近的更新,请参阅英文版文档

迁移到 Express 5

概述

Express 5.0 仍然处于 α 测试发布阶段,但我们可以在这里先睹为快,了解一下这个发行版中的变化以及如何将 Express 4 应用程序迁移到 Express 5。

Express 5 与 Express 4 的差异不是很大:对 API 的更改不像 3.0 到 4.0 升级那样大刀阔斧。虽然基本 API 保持相同,但仍有一些重大更改;换言之,如果将现有 Express 4 程序更新为使用 Express 5,那么该程序可能无法工作。

要安装最新的 α 测试版以预览 Express 5,请在应用程序根目录中输入以下命令:

$ npm install "express@>=5.0.1" --save

随后,可以运行自动化测试以查看哪些地方发生故障,然后根据以下列出的更新修复问题。在解决测试故障问题之后,运行应用程序以查看发生哪些错误。如果应用程序使用任何不受支持的方法或属性,您马上就可以发现。

Express 5 中的更改

以下是将影响 Express 用户的更改的列表(截至在 α R2)。 请参阅 pull request 以查看所有计划功能的列表。

已移除的方法和属性

已更改

改进

已移除的方法和属性

如果在应用程序中使用任何已删除的方法或属性,应用程序将崩溃。所以,需要在更新到 V5 之后更改应用程序。

app.del()

Express 5 不再支持 app.del() 函数。如果使用此函数,将抛出错误。要注册 HTTP DELETE 路由,请使用 app.delete() 函数。

最初之所以使用 del 而不是 delete,是因为 delete 是 JavaScript 中的保留关键字。但在 ECMAScript 6 时,delete 和其他保留关键字可以合法地用作属性名称。您可以在此阅读该讨论,这导致我们在此不推荐使用 app.del 函数。

app.param(fn)

app.param(fn) 特征符用于修改 app.param(name, fn) 函数的行为。自 V4.11.0 起不推荐使用该特征符,而 Express 5 完全不再提供支持。

复数的方法名称

以下方法名称已加复数。在 Express 4 中,使用旧方法时会出现不推荐使用的警告。Express 5 则完全不再支持:

req.acceptsCharset()req.acceptsCharsets() 取代。

req.acceptsEncoding()req.acceptsEncodings() 取代。

req.acceptsLanguage()req.acceptsLanguages() 取代。

app.param(name, fn) 的名称中的前置冒号 (:)

app.param(name, fn) 函数名称中的前置冒号字符 (:) 是 Express 3 的遗留问题,为了向后兼容性,Express 4 提供支持但会显示不推荐使用的提醒。而 Express 5 则静默忽略它,使用不带前置冒号的名称参数。

如果您遵循 app.param 的 Express 4 文档进行开发,那么不会影响代码,因为文档中没有提及前置冒号。

req.param(name)

已移除用于检索表单数据的方法,因为这可能引起混淆,而且很危险。现在,您需要在 req.paramsreq.bodyreq.query 对象中专门寻找提交的参数名称。

res.json(obj, status)

Express 5 不再支持特征符 res.json(obj, status)。而是设置状态,然后将其链接到 res.json() 方法,如下所示:res.status(status).json(obj)

res.jsonp(obj, status)

Express 5 不再支持特征符 res.jsonp(obj, status)。而是设置状态,然后将其链接到 res.jsonp() 方法,如下所示:res.status(status).jsonp(obj)

res.send(body, status)

Express 5 不再支持特征符 res.send(obj, status)。而是设置状态,然后将其链接到 res.send() 方法,如下所示:res.status(status).send(obj)

res.send(status)

Express 5 不再支持特征符 res.send(status),其中 status 是数字。而是使用 res.sendStatus(statusCode) 函数,它会设置 HTTP 响应头状态码并发送该代码的文字版:“Not Found”、“Internal Server Error”等。 如果需要使用 res.send() 函数来发送数字,请对该数字加上引号以将其转换为字符串,以便 Express 不会将其解释为尝试使用不受支持的旧特征符。

res.sendfile()

在 Express 5 中,res.sendfile() 函数已由驼峰式大小写版本 res.sendFile() 替换。

已更改

app.router

在 Express 4 中已移除的 app.router 对象在 Express 5 中已恢复。在新版本中,此对象只是对 Express 基本路由器的引用,不像在 Express 3 中应用程序必须显式将该路由器装入。

req.host

在 Express 4 中,如果存在端口号,req.host 函数会错误地将其剥离。在 Express 5 中,则会保留端口号。

req.query

在 Express 4.7 以及 Express 5 之后,如果您希望使用自己的查询字符串解析逻辑函数,查询解析器选项可以接受 false 以禁用查询字符串解析。

改进

res.render()

现在,此方法为所有查看引擎强制执行异步行为,避免具有同步实现以及违反建议接口的查看引擎所导致的错误。