Erreur de conflit de pré-rendu expérimentale

Type : boolean
Par défaut : false

Ajouté à la version : astro@5.14.0 Nouveau

Transforme les avertissements de conflit de pré-rendu en erreurs pendant le processus de compilation.

Astro vous avertit actuellement, lors de la compilation, de tout conflit entre plusieurs routes dynamiques pouvant générer le même chemin de sortie. Par exemple, /blog/[slug] et /blog/[...all] pourraient tous deux tenter de générer le chemin /blog/article-1. Dans ce cas, Astro génère uniquement la route la plus prioritaire pour le chemin en conflit. Cela permet à votre site d’être compilé correctement, même si vous pourriez constater que certaines pages sont générées par des routes inattendues.

Avec cette option expérimentale, la compilation échouera immédiatement avec une erreur. Cela vous obligera à résoudre immédiatement tout conflit de routage et garantira qu’Astro génère vos routes comme prévu.

Pour activer ce comportement, ajoutez l’option de fonctionnalité experimental.failOnPrerenderConflict à votre configuration Astro :

astro.config.mjs

import { defineConfig } from "astro/config"

defineConfig({
  experimental: {
    failOnPrerenderConflict: true,
  },
});

Utilisation

Après avoir activé cette option, vous risquez de rencontrer des erreurs concernant des routes pré-rendues en conflit lorsque vous tentez de compiler votre projet. Si cela se produit, vous devrez mettre à jour une ou plusieurs de vos routes dynamiques pour éviter tout routage ambigu.