Flags legacy

Para ayudar a algunos usuarios a migrar entre versiones de Astro, ocasionalmente introducimos flags legacy.

Estos flags te permiten optar por algunos comportamientos deprecados o desactualizados de Astro en la última versión, para que puedas continuar actualizando y aprovechar las nuevas releases de Astro hasta que puedas actualizar completamente el código de tu proyecto.

collectionsBackwardsCompat

Type: boolean
Default: false

Añadido en: astro@6.0.0

El flag legacy.collectionsBackwardsCompat proporciona compatibilidad hacia atrás temporal para proyectos que no pueden migrar a la Content Layer API introducida en v5.0.

astro.config.mjs

export default defineConfig({
  legacy: {
    collectionsBackwardsCompat: true,
  },
});

Este flag preserva algunas funcionalidades legacy de content collections de v4:

• Soporta type: 'content' y type: 'data' sin loaders
• Preserva la API de entrada legacy: entry.slug y entry.render()
• Usa IDs de entrada basados en rutas en lugar de IDs basados en slug

Este es un helper de migración temporal. Migra las colecciones a la Content Layer API, luego deshabilita este flag.