[译] 初窥 Express 5

前言

Express 5.0 仍处于alpha版中,但是我们还是想先来初窥一下新的express版本中将会有哪些改变,以及如何将你的应用从Express 4 迁移至 Express 5。

Express 5 与Express 4 的区别,并有像之前从Express 3 更新至 Express 4 时的那样非常巨大。但是,仍然还是有几个API有了颠覆性的变化。这意味着你的Express 4 应用在更新至Express 5 之后,将有可能不能运行。

安装

想要使用alpha版的Express 5 ,你只需在你应用的根目录下运行命令:

1
$ npm install express@5.0.0-alpha.2 --save

完成了以上步骤之后,你便可以运行你项目中的自动化测试,来看看有哪些代码运行失败了,然后根据下文列出的Express 5 的更新清单,来修复它们。(你的代码应该是有写测试的吧。。)接着,根据测试的错误信息,来实际运行你的应用,看看到底是发生了什么错误。这些错误应该都是使用了Express 5不再支持的属性和方法所导致的。

Express 5 的改变

以下是Express 5 的改变清单。当然,由于目前它还在一个alpha版,所以可能会有更多的变化。

被移除的方法和属性:

  • app.del()
  • app.param(fn)

被改变为复数形式的方法名:

以下这些方法名被更改为了复数形式。在Express 4 中,使用单数的方法名将会得到一个警告。而Express 5 则不再支持它们了:

  • req.acceptsCharset() -> req.acceptsCharsets().
  • req.acceptsEncoding() -> req.acceptsEncodings().
  • req.acceptsLanguage() -> req.acceptsLanguages().

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

app.param(name, fn)name的前置冒号是为了向前兼容Express 3。在Express 4 中,使用前置了冒号的name会得到一个警告。而在Express 5 中,将会默默得忽略它,然后使用没有前置冒号的name

如果你遵循的是Express 4的文档,这个改变不应该影响到你的应用。

req.param(name)

这个方法的方法名非常具有歧义,并且在获取已经被删除的数据时可能会有危险,所以它被移除了。你将必须从req.paramsreq.bodyreq.query来明确地获取指定数据。

res.json(obj, status)

Express 5 将不再支持方法res.json(obj, status)。取而代之的是,你可以通过status方法链式调用它,如:res.status(status).json(obj)

res.jsonp(obj, status)

Express 5 将不再支持方法res.jsonp(obj, status)。取而代之的是,你可以通过status方法链式调用它,如:res.status(status).jsonp(obj)

res.send(body, status)

Express 5 将不再支持方法res.send(obj, status)。取而代之的是,你可以通过status方法链式调用它,如:res.status(status).send(obj)

res.send(status)

Express 5 将不再支持status参数是数字的res.send(status)方法。取而代之的是,你可以使用res.sendStatus(status),它将会设置一个指定的HTTP响应码以及文字描述,如“Not Found”“Internal Server Error”等等。

如果你需要向res.send()传递一个数字,那就给这个数字用引号包围,来将其转换为一个字符串,然后Express 5 将不会认为你在使用旧的不再支持的方法。

res.sendfile()

Express 5 中,res.sendfile()被它的驼峰命名版本res.sendFile()所取代。

有所改变的方法和属性:

app.router

app.router对象在Express 4中被移除了,但是在Express 5 中,它有回归了。但是它与Express 3 中的不同,它只是一个对基本的Express router对象的引用,在你的应用中,你不许要显式的加载它。

req.host

Express 4中,req.host中会删去端口号,而在Express 5 中,端口号会被保留。

req.query

Express 4.7和Express 5 中,query parser接受false参数来禁用默认的查询字符串解释。然后你可以使用自己的查询字符串解释逻辑代替之。

有所改进的方法:

res.render()

对于所有的模板引擎,这个方法现在都会强制去使用它异步版本的编译方法,来避免在使用支持同步编译的模板引擎中可能会出现的bug。

结论

我们已经给了Express 5 中的所有改变的一个预览,以及升级你的应用的大致路径。但是由于它还处于一个alpha阶段,所以未来可能会有更多的变化。请保持关注StrongLoop

原文链接

https://strongloop.com/strongblog/moving-toward-express-5/