라이프사이클 훅

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 컴포저블에서도 사용할 수 있습니다.

app/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 라이프사이클 훅에 대해 더 알아보세요.

커스텀 훅 추가하기

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 'nitropack/types' {
  interface NitroRuntimeHooks {
    'your-nitro-hook': () => void
  }
}