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 不同，它需要显式加载。

迁移技巧

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

结论

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

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