# 静的生成

ページを静的としてマークすると、ファイルシステムベースのルーターがそのページを`@lazarv/react-server`のエクスポートに追加します。

ページを静的としてマークするには、ページの一致するパスに`.static.{js,mjs,ts,mts,json}`拡張子のファイルを作成し、そのルートで使用可能なパラメータの配列、パラメータの配列を返す関数、またはパラメータを逐次yieldする非同期ジェネレーター関数をデフォルトエクスポートします。関数は非同期関数にすることもできます。

パラメータのないページの場合は、デフォルトで`true`をエクスポートします。

```ts filename="users.static.ts"
export default true;
```

ページを静的としてマークする最も簡単な方法は、`true`を定義した`.static.json`ファイルを作成することです。

```json filename="users.static.json"
true
```

> **警告:** パラメータを持つルートでは`true`を値として使用できません。使用可能なパラメータの配列、またはパラメータの配列を返す関数を定義する必要があります。パラメータを持つルートで`true`を使用すると、ビルドが失敗します。

## 動的ルート

動的ルートの場合、`/users/:id`にページがある場合、`/users/[id].static.ts`に以下の内容のファイルを作成できます：

```ts filename="users/[id].static.ts"
export default [{ id: 1 }, { id: 2 }, { id: 3 }];
```

ルートパラメータの配列、またはルートパラメータの配列を返す非同期関数をエクスポートできます。

```ts filename="users/[id].static.ts"
export default async () => [{ id: 1 }, { id: 2 }, { id: 3 }];
```

関数はビルド時に実行され、その結果が静的ページの生成に使用されます。

## 静的パスのストリーミング

非常に多くのパスを持つルート（CMSから取得したページネーション付きコンテンツ、大規模データベースから読み込むslug、レンダリング開始前にリスト全体をメモリに展開するのが無駄になるあらゆるケース）では、デフォルトエクスポートを`async function*`（非同期ジェネレーター）として宣言し、パラメータ記述子を逐次yieldできます。総数に関わらずピークメモリは1記述子のまま、最初のyieldと同時にレンダリングを開始できます。

```js filename="users/[id].static.mjs"
export default async function* () {
  let cursor = null;
  do {
    const { items, next } = await fetchUsers(cursor);
    for (const user of items) {
      yield { id: user.id };
    }
    cursor = next;
  } while (cursor);
}
```

`{ ...params }`記述子（上記のようにルートのパラメータテンプレートにマッピングされます）または`{ path: "/explicit/path" }`記述子を完全な制御のためにyieldできます。完全に同期的なソースには同期`function*`ジェネレーターも同様に動作します。

> **注意:** 検出は関数の種類で行われます。デフォルトエクスポートとして`async function*`（または`function*`）を**直接**記述してください。通常の関数を返すラッパーは配列契約にフォールバックします。

## 静的JSONデータ

`.static.json`拡張子のファイルを作成することで、静的ページに静的JSONデータを使用できます。

たとえば、`/users/:id`にページがある場合、`/users/[id].static.json`に以下の内容のファイルを作成できます：

```json filename="users/[id].static.json"
[{ "id": 1 }, { "id": 2 }, { "id": 3 }]
```

> **注意:** 静的ルートはページコンポーネントとは独立して定義しています。これはルーティングとページレンダリングの関心事を分離するためです。この方法により、ルーターはビルド時にページコンポーネントを定義するコードをインポートする必要がなくなります。これは、ページコンポーネントの依存関係ツリーが大きい場合や、コードに副作用がある場合に便利です。

## 静的パスのオーバーライド

`@lazarv/react-server`の設定ファイルで`export()`関数を定義することで、すべての静的パスをオーバーライドできます。この関数はすべての静的パスの配列とともに呼び出され、デフォルトの静的パスをオーバーライドする新しいパスの配列を返すことができます。この例では、すべての静的パスから`/en`プレフィックスを削除しています。

```js filename="react-server.config.mjs"
export default {
  export(paths) {
    return paths.map(({ path }) => ({
      path: path.replace(/^\/en/, ""),
    }));
  },
};
```

この関数を使用して、新しい静的パスを追加したり、一部のパスを削除したりすることもできます。

```js filename="react-server.config.mjs"
export default {
  export(paths) {
    return [
      ...paths,
      { path: "/new-page" },
    ];
  },
};
```

```js filename="react-server.config.mjs"
export default {
  export(paths) {
    return paths.filter(({ path }) => path !== "/en");
  },
};
```

## エクスポートパスソースのストリーミング

通常の関数形式の`export`は配列を受け取ります。ファイルシステムルーターが解決したすべてのパスを一度に受け取る形です。ほとんどのアプリではこれで十分ですが、非常に大規模なエクスポート（数万ページ、CMSから取得するページネーションされたコンテンツ、動的に生成されるパスなど）では、レンダリング開始前にリスト全体をメモリ上に展開するのは効率的ではありません。ピークメモリがパス数に比例して増大し、最後のパスが収集されるまで最初のレンダリングを開始できないからです。

`export`を`async function*`（非同期ジェネレーター）として宣言すると、ストリーミングモードに切り替わります。ジェネレーターはファイルシステムルーターと`exportPaths`が生成するライブな`AsyncIterable`を受け取り、レンダラーにパスを1つずつ`yield`できます。レンダラーはワーカーが空いたときにのみパスをプルするため、ジェネレーターはエクスポートのちょうど1ステップ先を進む形になります。ピークメモリは総パス数に関係なく`O(パス記述子1つ分)`に保たれ、最初に`yield`されたパスからレンダリングが開始されます。並列レンダリングのために[`--export-concurrency`](/features/cli#build-export-concurrency)と組み合わせると効果的です。

```js filename="react-server.config.mjs"
export default {
  async *export(paths) {
    // ファイルシステムルーターが解決したパスをそのまま流す。
    for await (const p of paths) {
      yield p;
    }

    // その後、追加のパスを遅延的にyieldする。例: CMSからページ単位で取得、
    // 大規模なDBクエリから計算、ファイルから読み込み、など。
    let cursor = null;
    do {
      const { items, next } = await fetchPage(cursor);
      for (const item of items) {
        yield { path: `/posts/${item.slug}` };
      }
      cursor = next;
    } while (cursor);
  },
};
```

> **注意:** 検出は関数の種別で行われます。`export`の値として`async function*`（または`function*`）を**直接**書く必要があります。通常の関数を返すラッパー（メモ化、デコレーターなど）を介すると、レガシーな配列変換契約にフォールバックします。通常の関数形式は変更されておらず、「配列を渡してくれれば、変換した配列を返す」という用途には引き続きこちらが適しています。

## APIルートの静的エクスポート

APIルートを静的ルートとしてエクスポートすることもできます。これを行うには、静的パスを`path`、`filename`、`method`、`headers`プロパティを持つオブジェクトとして定義します。`path`はルートパス、`filename`は静的ファイルのファイル名、`method`はリクエストのHTTPメソッド、`headers`はリクエストのヘッダーを持つオブジェクトです。`method`と`headers`はオプションです。

```js filename="react-server.config.mjs"
export default {
  export() {
    return [
      {
        path: "/sitemap.xml",
        filename: "sitemap.xml",
        method: "GET",
        headers: {
          accept: "application/xml",
        },
      },
    ];
  },
}
```

## マイクロフロントエンドルートの静的エクスポート

マイクロフロントエンドルートを静的としてエクスポートすることもできます。これを行うには、静的パスを`path`と`remote`プロパティを持つオブジェクトとして定義します。`path`はルートパス、`remote`はそのルートがマイクロフロントエンドルートであり、ビルド時にリモートレスポンスペイロードを生成する必要があることを示すフラグです。マイクロフロントエンドの静的エクスポートを使用することで、ビルド時にマイクロフロントエンドのコンテンツを事前レンダリングし、アプリケーションのパフォーマンスを向上させることができます。

```js filename="react-server.config.mjs"
export default {
  export() {
    return [
      {
        path: "/",
        remote: true,
      }
    ];
  },
};
```

## アウトレットの静的エクスポート

アウトレットを静的としてエクスポートすることもできます。これを行うには、静的パスを`path`と`outlet`プロパティを持つオブジェクトとして定義します。`path`はルートパス、`outlet`はアウトレットの名前です。アウトレットの静的エクスポートを使用することで、ビルド時にアウトレットのコンテンツを事前レンダリングし、アプリケーションのパフォーマンスを向上させることができます。エクスポートされたアウトレットはRSCコンポーネントとしてレンダリングされます。エクスポートされたアウトレットへのクライアントサイドナビゲーションでは、サーバーにリクエストを送信する代わりに、静的なアウトレットコンテンツが使用されます。

```js filename="react-server.config.mjs"
export default {
  export() {
    return [{ path: "/photos/1", outlet: "modal" }];
  },
};
```

## RSCルートの静的エクスポートを無効化

`rsc`プロパティを`false`に設定することで、RSCルートの静的エクスポートを無効にできます。これは、ページがRSCルートであるが、ビルド時に事前レンダリングしたくない場合や、そのルートのRSCペイロードを使用する予定がない場合に便利です。これにより、ビルド時にRSCペイロードが生成されなくなり、ルートは通常のHTMLページとしてのみレンダリングされ、デプロイメントサイズが削減されます。

```js filename="react-server.config.mjs"
export default {
  export() {
    return [{ path: "/photos/1", rsc: false }];
  },
};
```