Express v您需要了解的有关 Express v5 的信息

express v您需要了解的有关 express v5 的信息

express 5 引入了一些重要的更改，可能会影响使用 express 4 构建的应用程序的兼容性。虽然核心 api 大部分保持不变，但一些已弃用的方法和行为已被删除或更新，可能会在迁移过程中导致问题。以下是更改、新行为和迁移技巧的简明细分，可帮助您顺利过渡。

安装要求

node.js 版本：18 或更高
安装 express 5：

npm install "express@>=5.0.0" --save

安装后，运行自动化测试以识别代码中任何损坏的部分，并根据下面列出的更改进行必要的更新。

express 5 的主要变化

删除的方法和属性

一些以前支持的方法和签名已被完全删除。使用这些现在将导致应用程序崩溃。

1。 app.del()

使用 app.delete() 代替删除路由。
示例：

app.delete('/users/:id', (req, res) => res.send('deleted'));

2。 app.param(fn)

通用的 app.param(fn) 不再可用。使用 app.param(name, fn) 修改路由参数

3。复数方法

为了更清晰而重命名的方法：

req.acceptscharset() → req.acceptscharsets()
req.acceptsencoding() → req.acceptsencodings()
req.acceptslanguage() → req.acceptslanguages()

4。 req.param(name) 已删除

直接从以下位置检索参数：

req.params（路由参数）
req.body（post 请求正文）
req.query（查询字符串）

5。更改了响应方法签名

res.json(obj, status) → 使用：

res.status(status).json(obj);

res.jsonp(obj, status) → 使用：

res.status(status).jsonp(obj);

res.redirect(url, status) → 使用：

res.redirect(status, url);

6。 res.send(body, status) 和 res.send(status) 已删除

使用 res.status() 来链接响应：

res.status(404).send('not found');

单独发送状态代码：

res.sendstatus(404);

7。 res.sendfile() → res.sendfile()

使用驼峰版本：

res.sendfile('/path/to/file.html');

8。魔术字符串“back”已弃用

res.redirect('back') → 使用：

res.redirect(req.get('referrer') || '/');

路由匹配语法的更改

通配符语法： 使用 /*splat 而不是 /*。
无可选字符支持： 替换 /route？与 /route{.:ext}.
删除正则表达式模式：显式定义多个路由：

app.get(['/discussion/:slug', '/page/:slug'], (req, res) => res.send('ok'));

中间件和异步错误处理

异步错误处理：如果异步路由处理程序抛出错误或返回拒绝的 promise，它会自动转发到错误处理程序：

app.get('/route', async (req, res, next) => {
  try {
    // Some async operation
  } catch (err) {
    next(err);  // Forward to error handler
  }
});

express 核心功能更新

1。 express.urlencoded()

扩展选项现在默认为 false。

2。 req.body **行为改变**

如果请求正文未解析，则 req.body 返回 undefined 而不是 {}。

3。 req.host **修复**

现在保留主机名中的端口号（如果存在）。

4。 req.query **变为只读**

查询对象现在是一个 getter，不能直接修改。

5。 res.clearcookie() **行为**

忽略 maxage 和过期选项。

6。 res.status() **验证**

现在仅接受 100-999 之间的整数状态代码。传递无效代码将引发错误。

7。 res.vary() **严格参数检查**

如果缺少字段参数，则会抛出错误。

新的改进

1。 res.render() 现在强制执行异步行为

这可以避免同步模板引擎违反异步接口的错误。

2。 brotli 压缩支持

express 5 现在支持开箱即用的 brotli 编码，改进了现代浏览器的压缩。

3。 app.router 回来了

app.router 对象再次可用，但充当基本 express 路由器的引用，与 express 3 不同，它需要显式加载。

迁移技巧

自动化测试：升级后运行测试套件以快速捕获重大更改。
更新已弃用的方法：检查代码中是否有已弃用的响应方法（例如 res.sendfile()），并将其更改为新的受支持版本。
针对异步错误重构中间件：确保您的异步处理程序使用 try-catch 块或正确返回 promise。
检查查询解析更改：如果您的应用严重依赖查询参数，请确保只读行为与您的代码逻辑一致。

结论

如果您仔细遵循更改，迁移到 express 5 会很简单。虽然大多数更新都围绕删除已弃用的方法和改进错误处理进行，但它们还为现代 web 应用程序提供了增强的可靠性。专注于重构过时的方法、彻底测试并采用异步实践，以获得更好的性能和更顺畅的开发。

以上就是Express v您需要了解的有关 Express v5 的信息的详细内容，更多请关注其它相关文章！