defineRouteRules

Source
Правила маршрутов для гибридного рендеринга на уровне страницы.
Функция экспериментальная; для использования включите опцию experimental.inlineRouteRules в nuxt.config.

Использование

app/pages/index.vue
<script setup lang="ts">
defineRouteRules({
  prerender: true,
})
</script>

<template>
  <h1>Hello world!</h1>
</template>

Эквивалентно конфигу:

nuxt.config.ts
export default defineNuxtConfig({
  routeRules: {
    '/': { prerender: true },
  },
})
При nuxt build главная страница пререндерится в .output/public/index.html и отдаётся статически.

Примечания

  • Правило в ~/pages/foo/bar.vue применяется к запросам /foo/bar.
  • Правило в ~/pages/foo/[id].vue — к запросам /foo/*.
  • Правило на странице с конечным набором альтернатив, например с path /:locale(en|fr)/about, создаёт по одному правилу на альтернативу (/en/about и /fr/about).

Если путь страницы нельзя преобразовать в эквивалентный шаблон route rule (например, параметр с регулярным выражением /:id(\d+), частичный сегмент /prefix-:id или повторяемый параметр /:slug+), правила для этой страницы не применяются, и Nuxt предупреждает при сборке. В таком случае задайте правила явно в nitro.routeRules в nuxt.config.

При кастомном path или alias в definePageMeta задавайте routeRules напрямую в nuxt.config.

Подробнее о routeRules.