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 应用程序提供了增强的可靠性。专注于重构过时的方法、彻底测试并采用异步实践，以获得更好的性能和更顺畅的开发。
