cacheHint と maxAge の指定方法
公開ページのHTMLを何秒使い回すか、どの記事の変更で更新するかを指定します。5秒の例で再生成も確認できます。
目次
公開記事の一覧を毎回組み立てずに配信したいときは、Astroのルートキャッシュを使います。maxAge は同じHTMLを使い回す時間、EmDashの cacheHint はそのHTMLにどのコンテンツを使ったかをAstroに伝える情報です。
どの値をどこで指定する?
| 値・設定 | 役割 | 教材での指定 |
|---|---|---|
cache.provider | 作成したHTMLを保存する場所 | astro.config.mjs で memoryCache()。起動中のNode.jsのメモリーに保存します |
cacheHint | 記事取得時に受け取る情報。tags が、内容の更新時に古いHTMLを無効にする目印になります | getEmDashCollection('posts', …) の戻り値から受け取ります |
maxAge | HTMLを再利用する秒数 | 5 なら5秒。例では古いHTMLを返しながら裏で更新する swr は指定しません |
Astro.cache.set(…) | 上の情報を、今表示しているページに設定する操作 | ...cacheHint で取得時のタグを引き継ぎ、maxAge を加えます |
5秒で期限が切れるページ
練習サイト「週末ノート」には、公開記事と memoryCache() の設定が入っています。weekend-note/src/pages/cache-window.astro を作り、次を保存してください。
---
import { getEmDashCollection } from 'emdash';
const { entries, error, cacheHint } = await getEmDashCollection('posts', { limit: 3 });
if (error) return new Response('記事を取得できませんでした。', { status: 500 });
if (Astro.cache.enabled) {
Astro.cache.set({ ...cacheHint, maxAge: 5 });
}
const renderedAt = new Date().toISOString();
---
<p>HTMLを作った時刻 <time>{renderedAt}</time></p>
<ul>{entries.map(post => <li>{post.data.title}</li>)}</ul>new Date().toISOString() は、サーバーがこのHTMLを作った時刻を世界標準時で書き込みます。画面を開いているあいだに動く時計とは違い、同じHTMLを受け取れば同じ時刻が読めます。
何が見えればキャッシュが効いている?
weekend-note のコマンド入力画面で次を実行し、本番用にビルドしたサイトを手元で起動します。すでに教材の4351番のサーバーを起動している場合は、その入力画面で先に Ctrl + C を押してください。
npm run build
npm startブラウザーのプライベートウィンドウで http://127.0.0.1:4351/cache-window/ を開きます。記事タイトル3件の上に「HTMLを作った時刻」が表示されます。
| 操作 | この設定での結果 |
|---|---|
| 開いてすぐに同じURLを開き直す | 1回目と同じ時刻。保存したHTMLを再利用しています |
| 最初に表示されてから6秒以上待ち、開き直す | 新しい時刻。期限が切れたあと、次のリクエストでHTMLを作り直します |
| その直後にもう一度開き直す | 直前と同じ時刻。新しく作ったHTMLの再利用が始まっています |
開発サーバーで試すと同じ動作を確かめられません。この教材では4350番が開発用、4351番が本番用ビルドです。サーバーを再起動すると、メモリーに保存したHTMLは消えます。
記事を公開したら、期限まで待つ?
更新する記事とページのタグが対応していれば、EmDashは公開時にそのタグのキャッシュを無効にします。次のアクセスでは、期限前でも新しい内容を表示できます。公開操作とキャッシュが別々のサーバーにある場合は、更新の通知が保存先へ届く構成が必要です。
ここで実行確認したのは、未ログインで読む一覧ページと、Node.jsのメモリーに保存したHTMLの有効期限です。公開操作による一覧・詳細の更新を実際に試す手順は、記事の公開後にキャッシュを更新する実習にあります。