extendPages

Nuxt에서는 pages 디렉토리의 파일 구조를 기반으로 라우트가 자동으로 생성됩니다. 그러나 이러한 라우트를 사용자 정의해야 하는 시나리오가 있을 수 있습니다. 예를 들어, Nuxt에 의해 생성되지 않은 동적 페이지에 대한 라우트를 추가하거나, 기존 라우트를 제거하거나, 라우트의 구성을 수정해야 할 수 있습니다. 이러한 사용자 정의를 위해 Nuxt는 extendPages 기능을 제공하여 페이지 구성을 확장하고 변경할 수 있습니다.

사용법

import { createResolver, defineNuxtModule, extendPages } from '@nuxt/kit'

export default defineNuxtModule({
  setup (options) {
    const { resolve } = createResolver(import.meta.url)

    extendPages((pages) => {
      pages.unshift({
        name: 'prismic-preview',
        path: '/preview',
        file: resolve('runtime/preview.vue'),
      })
    })
  },
})

타입

function extendPages(callback: (pages: NuxtPage[]) => void): void

매개변수

callback: 페이지 구성과 함께 호출되는 함수입니다. 이 배열을 추가, 삭제 또는 수정하여 변경할 수 있습니다. 참고: 제공된 페이지 배열을 직접 수정해야 하며, 복사된 배열에 대한 변경 사항은 구성에 반영되지 않습니다.

extendRouteRules

Nuxt는 Nitro 서버 엔진에 의해 구동됩니다. Nitro를 사용하면 리디렉션, 프록시, 캐싱 및 라우트에 헤더 추가와 같은 작업에 유용한 고급 로직을 구성에 직접 통합할 수 있습니다. 이 구성은 특정 라우트 설정과 라우트 패턴을 연결하여 작동합니다.

사용법

import { createResolver, defineNuxtModule, extendPages, extendRouteRules } from '@nuxt/kit'

export default defineNuxtModule({
  setup (options) {
    const { resolve } = createResolver(import.meta.url)

    extendPages((pages) => {
      pages.unshift({
        name: 'preview-new',
        path: '/preview-new',
        file: resolve('runtime/preview.vue'),
      })
    })

    extendRouteRules('/preview', {
      redirect: {
        to: '/preview-new',
        statusCode: 302,
      },
    })

    extendRouteRules('/preview-new', {
      cache: {
        maxAge: 60 * 60 * 24 * 7,
      },
    })
  },
})

타입

function extendRouteRules(route: string, rule: NitroRouteConfig, options?: ExtendRouteRulesOptions): void

매개변수

route: 일치시킬 라우트 패턴입니다.
rule: 일치하는 라우트에 적용할 라우트 규칙 구성입니다.

options: 라우트 구성에 전달할 객체입니다. override가 true로 설정되면 기존 라우트 구성을 덮어씁니다.

addRouteMiddleware

모든 라우트 또는 특정 라우트에 사용할 수 있는 라우트 미들웨어를 등록합니다.

라우트 미들웨어는 addRouteMiddleware 컴포저블을 통해 플러그인에서도 정의할 수 있습니다.

사용법

import { addRouteMiddleware, createResolver, defineNuxtModule } from '@nuxt/kit'

export default defineNuxtModule({
  setup () {
    const { resolve } = createResolver(import.meta.url)

    addRouteMiddleware({
      name: 'auth',
      path: resolve('runtime/auth'),
      global: true,
    }, { prepend: true })
  },
})

타입

function addRouteMiddleware(input: NuxtMiddleware | NuxtMiddleware[], options?: AddRouteMiddlewareOptions): void

매개변수

input: 다음 속성을 가진 미들웨어 객체 또는 미들웨어 객체 배열입니다:

options: 다음 속성을 가진 객체입니다: