nuxt logo

문서 번역(비공식)

prerenderRoutes

prerenderRoutes는 Nitro에게 추가 경로를 사전 렌더링하도록 힌트를 줍니다.

사전 렌더링 시, 생성된 페이지의 HTML에 URL이 나타나지 않더라도 Nitro에게 추가 경로를 사전 렌더링하도록 힌트를 줄 수 있습니다.

prerenderRoutesNuxt 컨텍스트 내에서만 호출할 수 있습니다.

prerenderRoutes는 사전 렌더링 중에 실행되어야 합니다. 사전 렌더링되지 않은 동적 페이지/경로에서 prerenderRoutes를 사용하면 실행되지 않습니다.

const route = useRoute()

prerenderRoutes('/')
prerenderRoutes(['/', '/about'])

브라우저에서 또는 사전 렌더링 외부에서 호출될 경우, prerenderRoutes는 아무런 효과가 없습니다.

API 경로도 사전 렌더링할 수 있으며, 이는 완전한 정적 생성 사이트(SSG)에서 특히 유용합니다. 서버가 있는 것처럼 데이터를 $fetch할 수 있기 때문입니다!

prerenderRoutes('/api/content/article/name-of-article')

// 앱의 다른 곳에서
const articleContent = await $fetch('/api/content/article/name-of-article', {
  responseType: 'json',
})

프로덕션에서 사전 렌더링된 API 경로는 배포하는 제공자에 따라 예상되는 응답 헤더를 반환하지 않을 수 있습니다. 예를 들어, JSON 응답이 application/octet-stream 콘텐츠 타입으로 제공될 수 있습니다. 항상 사전 렌더링된 API 경로를 가져올 때 responseType을 수동으로 설정하세요.