v3
GitHub

生命周期钩子

Nuxt 提供了一个强大的钩子系统，可以通过钩子扩展几乎所有方面。
钩子系统由 unjs/hookable 提供支持。

Nuxt 钩子（构建时）

这些钩子可用于 Nuxt 模块 和构建上下文。

在 nuxt.config.ts 中

nuxt.config.ts
export default defineNuxtConfig({
  hooks: {
    close: () => { }
  }
})

在 Nuxt 模块中

import { defineNuxtModule } from '@nuxt/kit'

export default defineNuxtModule({
  setup (options, nuxt) {
    nuxt.hook('close', async () => { })
  }
})
探索所有可用的 Nuxt 钩子。

应用钩子（运行时）

应用钩子主要供 Nuxt 插件 用于挂载渲染生命周期，也可以用于 Vue 组合函数中。

plugins/test.ts
export default defineNuxtPlugin((nuxtApp) => {
  nuxtApp.hook('page:start', () => {
    /* 你的代码写在这里 */
  })
})
探索所有可用的应用钩子。

服务器钩子（运行时）

这些钩子可供 服务器插件 使用，以挂载 Nitro 的运行时行为。

~/server/plugins/test.ts
export default defineNitroPlugin((nitroApp) => {
  nitroApp.hooks.hook('render:html', (html, { event }) => {
    console.log('render:html', html)
    html.bodyAppend.push('<hr>Appended by custom plugin')
  })

  nitroApp.hooks.hook('render:response', (response, { event }) => {
    console.log('render:response', response)
  })
})
了解更多可用的 Nitro 生命周期钩子。

额外钩子

了解更多关于创建自定义钩子的内容，请参阅事件部分。