通过 100+ 条技巧学习 Nuxt!

插件和中间件

了解如何将 Nuxt 2 的插件和中间件迁移到 Nuxt 3。

插件

插件现在具有不同的格式,并且只接受一个参数 (nuxtApp)。

export default (ctx, inject) => {
  inject('injected', () => 'my injected function')
})
文档 > 指南 > 目录结构 > 插件 中阅读更多内容。
阅读更多关于 nuxtApp 格式的内容。

迁移

  1. 迁移你的插件以使用 defineNuxtPlugin 辅助函数。
  2. 删除位于你的 plugins/ 文件夹中的 nuxt.config 插件数组中的任何条目。此目录顶层的所有文件(以及任何子目录中的任何索引文件)都将自动注册。你可以通过文件名来指示它是 client 还是 server,而无需将 mode 设置为 clientserver。例如,~/plugins/my-plugin.client.ts 将仅在客户端加载。

路由中间件

路由中间件具有不同的格式。

export default function ({ store, redirect }) {
  // If the user is not authenticated
  if (!store.state.authenticated) {
    return redirect('/login')
  }
}

与 Nuxt 2 非常相似,放置在你的 ~/middleware 文件夹中的路由中间件会自动注册。然后你可以在组件中按名称指定它。但是,这是使用 definePageMeta 而不是作为组件选项完成的。

navigateTo 是许多路由辅助函数之一。

文档 > 指南 > 目录结构 > 中间件 中阅读更多内容。

迁移

  1. 迁移你的路由中间件以使用 defineNuxtRouteMiddleware 辅助函数。
  2. 任何全局中间件(例如在你的 nuxt.config 中)都可以放在你的 ~/middleware 文件夹中,并带有 .global 扩展名,例如 ~/middleware/auth.global.ts