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 的信息的详细内容，更多请关注【创想鸟】其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至253000106@qq.com举报，一经查实，本站将立刻删除。
发布者：PHP中文网，转转请注明出处：https://www.chuangxiangniao.com/p/2664242.html
