Хуки жизненного цикла

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>Добавлено пользовательским плагином')
  })

  nitroApp.hooks.hook('render:response', (response, { event }) => {
    console.log('render:response', response)
  })
})
Хуки жизненного цикла Nitro на сервере.

Добавление дополнительных хуков

Свои хуки регистрируют через расширение интерфейсов хуков Nuxt.

import type { HookResult } from '@nuxt/schema'

declare module '#app' {
  interface RuntimeNuxtHooks {
    'your-nuxt-runtime-hook': () => HookResult
  }
  interface NuxtHooks {
    'your-nuxt-hook': () => HookResult
  }
}

declare module 'nitro/types' {
  interface NitroRuntimeHooks {
    'your-nitro-hook': () => void
  }
}