Static Paths API Reference

Adicionado em: astro@6.0.0 Beta

This module provides utilities to help adapters collect static paths from within their target runtime (e.g. workerd). This only provides a real implementation in the prerender Vite environment. In other environments, it returns a no-op implementation.

Imports from astro:static-paths

import {
  StaticPaths,
} from 'astro:static-paths';

StaticPaths

Allows adapters to collect all paths that need to be prerendered from within their target runtime. This is useful when implementing a custom prerenderer that runs in a non-Node environment:

The StaticPaths constructor accepts a required SSR manifest and an object describing the route cache and providing a method to access the component used to render the route. The preferred method to initiate a StaticPaths instance is to pass it an app instance or a Node app instance.

The following example initializes a StaticPaths instance from an app in an adapter server entrypoint:

my-adapter/server.js

import { App } from 'astro/app';
import { StaticPaths } from 'astro:static-paths';

export function createExports(manifest) {
  const app = new App(manifest);
  const staticPaths = new StaticPaths(app);

  const handler = (event, context) => {
    // do something with `staticPaths`
  };

  return { handler };
}

StaticPaths.getAll()

Type: () => Promise<Array<{ pathname: string, route: RouteData }>>

Retrieves all paths that should be prerendered. This returns a promise that resolves to an array of objects describing the route path and its data.

The following example collects all static paths to be pre-rendered before returning them as Response in an adapter handler:

my-adapter/handler.js

import { StaticPaths } from 'astro:static-paths';

export function createHandler(app) {
  return async (request) => {
    const { pathname } = new URL(request.url);

    // Endpoint to collect static paths during build
    if (pathname === '/__astro_static_paths') {
      const staticPaths = new StaticPaths(app);
      const paths = await staticPaths.getAll();
      // Returns array of { pathname: string, route: RouteData }
      return new Response(JSON.stringify({ paths }));
    }

    // ... handle other requests
  };
}