我们正持续致力于发布 Nitro v3、Nuxt v4 等。但我们很高兴能在圣诞节(及时)推出 Nuxt v3.15。
❄️ 降雪!
节日快乐!当您启动 Nuxt 时,您会注意到(如果您在北半球)加载屏幕上有一些雪(#29871).
⚡️ 包含 Vite 6
Nuxt v3.15 首次包含Vite 6。尽管这是一个主要版本,但我们预计这不会对 Nuxt 用户造成重大更改(请参阅完整的迁移指南)。但是,如果您的依赖项依赖于特定的 Vite 版本,请务必小心。
Vite 6 最重要的变化之一是新的 Environment API,我们希望将其与 Nitro 结合使用,以改善服务器开发环境。敬请关注!
您可以在Vite 6 变更日志.
中阅读完整的更改列表。
🪵 Chromium devtools 改进
我们经常谈论 Nuxt DevTools,但 v3.15 在开发模式下与基于 Chromium 的浏览器开发工具进行了更好的集成。我们现在使用 Chrome DevTools 可扩展性 API来添加对在浏览器开发工具性能面板中打印 Nuxt 钩子计时器的支持。
🗺️ callOnce 的导航模式
callOnce 是 Nuxt 内置的组合式函数,用于仅运行一次代码。例如,如果代码在服务器上运行,它就不会在客户端再次运行。但有时您确实希望代码在*每次导航*时运行——只是避免初始的服务器/客户端双重加载。为此,新增了一个 mode: 'navigation' 选项,它将仅在*每次导航*时运行一次代码。(请参阅#30260了解更多信息。)
await callOnce(() => counter.value++, { mode: 'navigation' })
🥵 模板、页面和页面元数据的 HMR
我们现在为 Nuxt 的虚拟文件(如路由、插件、生成的文件)以及页面元数据(在 definePageMeta 宏中)的内容实现了热模块重载(#30113).
这意味着您在开发过程中会有更快的体验,并且在更改路由时无需重新加载页面。
📋 页面元数据增强
我们现在支持通过 experimental.extraPageMetaExtractionKeys 提取额外的页面元数据键(可能由模块作者使用)(#30015)。这使模块作者可以在构建时,在 pages:resolved 钩子中使用此信息。
我们现在还支持在 definePageMeta 中使用本地函数(#30241)。这意味着您可以做这样的事情:
function validateIdParam(route) {
return !!(route.params.id && !isNaN(Number(route.params.id)))
}
definePageMeta({
validate: validateIdParam,
})
🔥 性能改进
如果应用程序清单将在水合应用程序时使用,我们现在会在浏览器中预加载它(#30017).
如果可能的话,我们还会将 vue-router 的 hash 模式历史记录从您的捆绑包中进行 tree shake——具体来说,如果您没有自定义您的 app/router.options.ts (#30297).
🐣 v4 更新
v4 的新默认值又进行了一些更改,包括默认情况下仅对 Vue 组件内联样式(#30305).
✅ 升级
像往常一样,我们建议您运行以下命令进行升级
npx nuxi@latest upgrade --force
这也将刷新你的 lockfile,并确保你拉取 Nuxt 依赖的其他依赖项(尤其是在 unjs 生态系统中)的更新。
完整的发布说明
衷心感谢所有参与本次发布的人。❤️
如果你有任何反馈或问题,请随时告诉我们!🙏