| name | browser-agent |
| description | agent-browser CLIを使ってローカルアプリのUIをテストする。 |
Browser Agent
agent-browser CLIを使ってローカルアプリのUIをテストする。
前提条件
- agent-browserがインストール済み(
npm install -g agent-browser)
- Chromiumダウンロード済み(
agent-browser install)
- 開発サーバーが起動していること(例:
pnpm dev)
手順
Step 1: プロジェクト情報の確認
CLAUDE.mdを読み込み、プロジェクトの技術スタックを把握
- 対象URLを確認(通常は http://localhost:4321 または http://localhost:3000)
Step 2: 基本UI検査
以下を順次実行:
- ページを開く
agent-browser open <url>
- スクリーンショット撮影
agent-browser screenshot --full-page
- 要素スナップショット取得(参照ID付き)
agent-browser snapshot -i
Step 3: レスポンシブテスト
以下のビューポートで順次テスト:
Desktop (1920x1080)
agent-browser viewport 1920 1080
agent-browser screenshot -o desktop.png
Tablet (768x1024)
agent-browser viewport 768 1024
agent-browser screenshot -o tablet.png
Mobile (375x667)
agent-browser viewport 375 667
agent-browser screenshot -o mobile.png
各サイズでレイアウト崩れやオーバーフローを確認。
Step 4: インタラクションテスト
スナップショットで取得した参照ID(@e1, @e2など)を使用:
agent-browser click @e1
agent-browser type @e2 "テスト入力"
agent-browser scroll down 500
Step 5: 情報取得
agent-browser text @e1
agent-browser html @e1
agent-browser attr @e1 href
Step 6: レポート作成
以下の形式でまとめる:
## UI Test Report
### 概要
- 対象URL: [URL]
- テスト日時: [日時]
### デスクトップ (1920x1080)
- [問題点または「問題なし」]
### タブレット (768x1024)
- [問題点または「問題なし」]
### モバイル (375x667)
- [問題点または「問題なし」]
### インタラクション
- [動作確認結果]
### 推奨改善
1. [改善提案]
2. [改善提案]
便利なオプション
--headed: ブラウザウィンドウを表示(デバッグ用)
--json: JSON形式で出力
--session <name>: セッション名を指定
注意事項
- サーバーが起動していない場合は明確にエラーを表示
- スクリーンショットは
-o で保存先を指定可能
- 参照ID(@ref)はスナップショット実行後に有効