laravel:e2e-playwright について
Laravel プロジェクトで信頼性と保守性の高い Playwright エンドツーエンドテストを作るためのスキルです。テスト環境、状態の準備、安定したセレクター、認証、失敗時のみの記録を扱います。
主な機能
- 01専用の `.env.playwright` 環境
- 02Seeder と Factory によるテスト状態の準備
- 03安定した `data-testid` セレクター
- 04認証ストレージ状態の再利用
- 05失敗時のみメディアを記録
活用シーン
- 01E2E テスト用のデータ投入済み環境の準備
- 02UI リファクタリング中のセレクター安定化
- 03テスト準備で不安定な UI ログインを回避
- 04失敗後のスクリーンショットや動画の取得
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ jpcaparas/ superpowers-laravel --skill laravel:e2e-playwrightインストール後、Claude Code で/laravel:e2e-playwrightを入力して読み込まれたか確認します。
詳細
E2E Playwright(Laravel)
E2E テストの信頼性、速度、保守性を維持します。
環境
# Sail
sail pnpm playwright:test
# Non‑Sail
pnpm playwright:test
専用の .env.playwright を使用し、実行前に migrate:fresh --seed でスキーマを再構築します。
状態とシード
- よく使うシナリオ(ユーザー、ロール、デモコンテンツ)用のシーダーを用意します
- テストごとのセットアップにはファクトリーを使用し、スペック間で状態をリセットします
テスト ID とセレクター
- CSS パスより
data-testid属性を優先します - リファクタリング後もセレクターが安定するようにします
認証
- 可能な場合はストレージ状態(ログイン済みの Cookie/セッション)を再利用します
- それ以外の場合は、UI ログインの不安定さを避けるため、API/セットアップを通じてユーザーを作成します
パターン
- 大きなフローをステップに分割し、重要なマイルストーンをアサートします
- スイートを高速に保つため、動画/スクリーンショットは失敗時のみ記録します
コメント
Markdown 対応