agent-browser

agent-browser でインターフェースをテストする

インストール済みの agent-browser CLI を使用して、レンダリングされたユーザー向け画面を検証します。コマンド構文を使用する前に、バージョンに対応した手順を読み込んでください。

agent-browser skills get core --full

対象に専用のガイドが必要な場合は、同梱されている専用ガイドを使用してください。利用可能なガイドは agent-browser skills list で確認できます。

検証ループ

1. 対象のアプリケーションを起動するか特定し、正確な URL とビューポートを記録します。
2. 名前付きセッションでページを開きます。
3. アクセシビリティスナップショットを取得し、ロール、ラベル、またはスナップショットの参照情報でコントロールを特定します。
4. ユーザー操作を実行します。
5. 結果の状態を待ってから、新しいスナップショットを取得します。画面遷移や大幅な DOM 更新の後は、参照情報が古くなることがあります。
6. 目視で確認できる結果、コンソールエラー、関連するネットワーク動作を検証します。
7. 視覚的な証拠が結果の裏付けに役立つ場合は、スクリーンショットを撮影します。

EmDash の管理画面をテストする場合は、パスキーを自動操作しようとせず、開発用バイパスを使用して認証します。

agent-browser open 'http://localhost:4321/_emdash/api/setup/dev-bypass?redirect=/_emdash/admin'

セットアップがすでに完了している場合は、代わりに auth/dev-bypass を使用してください。

操作のガイダンス

• ユーザー向けのコントロールを明確に表す場合は、ロールやラベルによるロケーターを優先します。効率よく画面を調べるには、スナップショットの参照情報を使用します。
• ダイアログが開いた後、ルートが変わった後、またはコンテンツが置き換わった後は、スナップショットを再取得します。
• タイミング自体がテスト対象である場合を除き、固定時間の待機を追加するのではなく、セレクターまたは表示状態を待ちます。
• Cookie やストレージに依存するフローでは、名前付きセッションを使用します。不要になったセッションは閉じます。
• UI の予期しない動作がある場合は、agent-browser console と agent-browser errors を確認します。
• 結果がリクエストまたはレスポンスの境界に依存する場合は、agent-browser network requests を使用します。

証拠

テストしたパス、入力、ビューポート、期待される結果、実際の結果、コンソールまたはリクエストの失敗を記録します。UI を変更した場合は、影響を受けるすべての画面について変更前と変更後のスクリーンショットを撮影します。

説明的なファイル名を付けて、タスクのワークスペース内にスクリーンショットを保存します。成功を報告する前に、保存した画像を確認してください。スクリーンショットコマンドの完了だけでは、意図した状態が表示された証拠にはなりません。

安定した自動テストで動作を保護できる場合、ブラウザーでの探索は回帰テストの代わりにはなりません。タスクに実装が含まれる場合は、確認済みの不具合を、意義のある最小範囲の自動テストにしてください。