wweb.dev 上の変更を検証する
完全に静的な Astro サイト(React アイランド使用)。検証とは、ビルドしたページをブラウザで読み込み、ハイドレーションされたアイランドと対話することを意味します。
ビルド + サーブ
yarn install # サーバーの依存関係が不足している場合(server.mjs には compression/express が必要)
yarn build # 静的ビルド → dist/(TZ=UTC が組み込まれる)
yarn serve # 本番サーバー(http://localhost:4321、astro preview ではありません)
node server.mjs は Yarn PnP に類似したセットアップでは直接失敗します。必ず yarn serve を使用してください。バックグラウンドで実行し、curl -s -o /dev/null -w "%{http_code}" http://localhost:4321/<route> でプローブします。
ページを操作する
リポジトリには Playwright は含まれていません。スクラッチディレクトリに playwright-core をインストールし、システムの Chrome を使用してください(chromium.launch({ channel: 'chrome', headless: true }))— ブラウザのダウンロードは不要です。アイランドは client:visible なので、アイランドがレンダリングしたセレクタをアサートする前に待機し、アニメーションには約1秒の猶予を与えてください。
ジェネレーターツールに役立つチェック:
- 注入された
<style>出力の計算スタイル(animation-name、position、size) - コピー可能な HTML/CSS コードの textarea
.inputValue() - 1440px および約 480px でのスクリーンショット(いくつかのツールサイドバーはモバイルで
column-reverseに反転します)
注意点
- コンソールはエラーフリーであるべきです。Vite アセットインライン化は無効になっています(
assetsInlineLimit: 0in astro.config.mjs)。これはデータ URI フォントが CSPfont-src 'self'に違反するためです — もし data-URI CSP エラーが再発した場合、その設定が失われています。 yarn test:parityにはtest/baseline/(本番 HTML スナップショット)が必要ですが、これはチェックインされていません。それがないとハーネスは ENOENT で失敗します。いずれにせよ、ブラウザ検証の代わりにはなりません。