商品の説明は全員に共通でも、ログイン中の人に表示する配送先は異なる場合があります。配送先の取得が遅ければ、商品説明まで待たせるべきでしょうか。本稿では架空の書籍販売ページを使い、共通の本文とユーザー別領域を分ける判断を考えます。対象はAstroのサーバーアイランドで、ブラウザーでボタンなどを動かすクライアントアイランドとは役割が異なります。
1. 初期ドキュメントと後から届く領域を分ける
Astro公式のサーバーアイランド文書は、特定コンポーネントのサーバーレンダリングを遅らせ、別のリクエストで結果を受け取る仕組みを説明しています。初期HTMLには中心となる本文と待機中の表示を入れ、別の応答が届いたら該当領域を置き換えます。そのため、サーバーでリクエストを処理するアダプターが必要です。
書籍販売ページでは、題名・著者・紹介を共通ドキュメントに残し、配送先の要約だけを候補にしてみます。訪問者は配送先を待つ間も、どんな本か読めます。一方、注文総額が分からないと決済ボタンを理解できない場合は、価格と決済操作の関係まで一緒に設計すべきです。見える要素を小さな箱に切り分けるだけで機能の分離が完了するわけではありません。
成否を決めるのは、何を先に見せるかです。本文をほぼ空にして大半を遅延させると、訪問者は複数の読み込み表示を待つことになります。最初の画面で答えるべき問いと、遅れてもよい情報を先にリストで分けましょう。サーバーアイランドは待つ場所を変える道具であり、データベース検索自体を自動で高速化する機能ではありません。
2. fallbackも完成した画面の一部として設計する
次は使い方を示す小さな例です。UserDeliveryコンポーネントとアダプターは別途実装済みとします。
---
import UserDelivery from '../components/UserDelivery.astro';
---
<UserDelivery server:defer>
<p slot="fallback">配送先情報を確認しています。</p>
</UserDelivery>
fallbackは一瞬現れて消える装飾ではなく、訪問者が実際に読む初期コンテンツです。配送先カードの最終サイズに近い領域を確保し、何を待っているのか説明します。情報がまだないのに「配送可能」と先に表示すると、実際の応答と意味が矛盾しかねません。不明な状態と確認済みの結果は見た目でも区別する必要があります。
例えば未ログインの人には「ログインすると保存した配送先を確認できます」という案内が必要かもしれません。通信が遅い状態と未ログインの状態は別です。それぞれの文言と移動先を決めておけば、開発時の仮の文章が運用画面に残ることを減らせます。
3. データの境界を小さく保つ
コンポーネントには表示と取得に必要な値だけを渡しましょう。全注文履歴を渡して名前一つしか表示しない構造なら、まずデータ依存を減らす余地があります。公開本文に置ける値もあれば、認証後にだけ取得すべき値もあります。値の受け渡し経路と画面に出力される範囲を同じ一覧で確認します。
サーバーアイランドのリクエストは別の実行コンテキストにあります。現在のページのアドレスが必要なら、元のページから必要なパスを明示的に渡す方法を検討しましょう。アイランド内のリクエストURLを元の商品ページURLだと仮定すると、ページ別の推薦や戻るリンクを誤って作る可能性があります。実装時には開発者ツールで実際のリクエスト先を確認する方が安全です。
書籍番号とユーザー識別情報を扱う架空の例を考えます。書籍番号は共通の推薦資料の取得に使い、ユーザー情報はサーバーが認証状態に応じて処理するよう役割を分けます。暗号化された転送形式を使っても、サーバーの権限確認の代わりにはなりません。入力を受け取る場所と、最終的にアクセスを許可する場所を分けて文書化しましょう。
4. キャッシュは画面の対象に合わせて決める
共通の書籍紹介と個人の配送先に同じキャッシュ方針を適用するのは困難です。MDNのHTTPキャッシュガイドは共有キャッシュとプライベートキャッシュの違いを説明しています。データが同じかより先に、誰に見せてもよい応答かを判断すべきです。
テストアカウント二つで同じページを開き、一人目の配送先が二人目に表示されないか確認します。ログアウト後の戻る操作や再読み込みも調べます。この検査は、キャッシュサーバー・ブラウザー・アプリの認証処理が一緒に動いた結果を対象とします。コンポーネントファイルを読むだけで安全とは結論できません。
共通の書籍推薦など共有できる部分にも、内容変更時の更新経路が必要です。古い推薦を一時的に許すのか、管理者の修正後すぐ置き換えるのか決めましょう。「キャッシュを有効にする」の一言ではなく、対象・保存場所・許容する古さ・無効化条件を書くと、他の開発者も設計を検討しやすくなります。
5. 遅い接続と失敗を先に試す
正常な接続で一度開いただけでは評価しません。配送先の取得を遅らせ、失敗させ、ログイン状態を変えて各画面を確認します。中心となる本文を読めるか、読み込み領域が次のボタンを押し下げ続けないか、失敗した情報に依存する操作が可能になっていないかを調べましょう。
| 試験する状況 | 訪問者が理解すべき状態 |
|---|---|
| 配送先の取得が遅い | 何を待ち、他の内容を読んでもよいか |
| 認証されていない | ログイン案内と共通説明が見えるか |
| 取得に失敗 | 空白画面の代わりに復旧経路を見つけられるか |
| アカウント変更 | 前のユーザーの情報が残らないか |
複数のアイランドが互いの結果を待つなら、分離方法も再検討が必要です。配送先の後に送料を取得し、その後で決済案内を描く構造では、待つリクエストが連続する可能性があります。関連情報を一つのサーバー処理にまとめるか、ユーザーが求めた時点で取得する方がよい場合もあります。分離数の多さだけでよい構造とはいえません。
6. 導入前後の効果を同じ条件で比べる
比較記録では、最初の本文が見えた時刻、配送先表示の完了、操作可能になった時刻、エラー状態を分けます。初期文書が早く見えても、配送先カードが大きく移動したり決済の開始が遅くなったりすれば、体験は別の方向に変わり得ます。平均一つだけでなく、遅いケースで何を待っていたかも残しましょう。
候補を選ぶ問いは具体的なほど役立ちます。「このサイトは静的か」より「この情報が遅れても書籍紹介を先に読めるか」の方が実装判断に有効です。Astroのオンデマンドレンダリングガイドと併せて配備環境を確認し、まず小さなユーザー別領域一つから実際の失敗まで検証しましょう。