StaticPaths Class — astro Architecture

Source Code

packages/astro/src/runtime/prerender/static-paths.ts lines 24–119

export class StaticPaths {
	#app: StaticPathsApp;

	constructor(app: StaticPathsApp) {
		this.#app = app;
	}

	/**
	 * Get all static paths for prerendering with their associated routes.
	 * This avoids needing to re-match routes later, which can be incorrect due to route priority.
	 */
	async getAll(): Promise<PathWithRoute[]> {
		const allPaths: PathWithRoute[] = [];
		const manifest = this.#app.manifest;

		// Collect routes to generate (mirrors retrieveRoutesToGenerate)
		const routesToGenerate: RouteData[] = [];
		for (const { routeData } of manifest.routes) {
			// Skip non-prerendered routes
			if (!routeData.prerender) continue;

			// Include redirects
			if (routeIsRedirect(routeData)) {
				routesToGenerate.push(routeData);
				continue;
			}

			// Include fallbacks if i18n has fallback configured
			if (routeIsFallback(routeData) && manifest.i18n?.fallback) {
				routesToGenerate.push(routeData);
				continue;
			}

			// Regular page
			routesToGenerate.push(routeData);
		}

		// Get paths for each route (mirrors getPathsForRoute)
		for (const route of routesToGenerate) {
			// Also process fallback routes
			for (const currentRoute of eachRouteInRouteData(route)) {
				const paths = await this.#getPathsForRoute(currentRoute);
				allPaths.push(...paths);
			}
		}

		return allPaths;
	}

	/**
	 * Get paths for a single route.
	 * Note: Does not filter duplicates - that's handled by generate.ts with conflict detection.
	 */
	async #getPathsForRoute(route: RouteData): Promise<PathWithRoute[]> {
		const paths: PathWithRoute[] = [];
		const manifest = this.#app.manifest;
		const routeCache = this.#app.pipeline.routeCache;

		// Static route - single pathname
		if (route.pathname) {
			paths.push({ pathname: route.pathname, route });
			return paths;
		}

		// Dynamic route - need to call getStaticPaths
		// Use pipeline.getComponentByRoute which handles redirects and fallbacks
		const componentInstance = await this.#app.pipeline.getComponentByRoute(route);

		// Determine which route to use for getStaticPaths
		const routeToProcess = routeIsRedirect(route)
			? route.redirectRoute
			: routeIsFallback(route)
				? getFallbackRoute(route, manifest.routes)
				: route;

		const actualRoute = routeToProcess ?? route;

		// Use callGetStaticPaths to populate the route cache
		const staticPaths = await callGetStaticPaths({
			mod: componentInstance,
			route: actualRoute,