Playwright MCP

🚀 Playwright

Playwrightは、マルチブラウザに対応した自動化テストツールです。このツールを使用することで、開発者は様々なブラウザでのテストを簡単に行うことができ、テストの網羅性と信頼性を確保します。

🚀 クイックスタート

playwright CLIを使用してブラウザを起動し、コマンドを実行する

ブラウザを起動してコマンドを実行するには、playwright CLIを使用します。

# chromeで "whoAmI" コマンドを実行する
playwright chrome -- eval 'await page.evaluate(() => { return window.whoAmI; })'

# firefoxで ".getTitle" を実行する
playwright firefox -- get-title

# webkitで "getScreenInfo" を実行する
playwright webkit -- get-screen-info

✨ 主な機能

Playwrightは、以下のような様々な機能を提供しています。

1. 多プラットフォーム対応：Chromium、Firefox、WebKitを同じコードベースでテストできます。
2. 組み込みツール：アサーション（assertions）、ファイルダウンロード処理、自動生成される待機条件などが含まれています。
3. 拡張性：プラグインシステムを通じてカスタム機能を追加できます。

📦 インストール

Playwrightを使用するには、まずブラウザをインストールする必要があります。ブラウザがインストールされていない場合は、browserInstall コマンドを使用してインストールできます。

# 指定された設定のブラウザをインストールする
browserInstall

💻 使用例

基本的な使用法

# chromeで "whoAmI" コマンドを実行する
playwright chrome -- eval 'await page.evaluate(() => { return window.whoAmI; })'

高度な使用法

# firefoxで ".getTitle" を実行する
playwright firefox -- get-title

📚 ドキュメント

Playwrightがサポートするブラウザとそのコマンド

Playwrightは現在、以下のブラウザをサポートしています。

• chromium
  • --headless：ヘッドレスモード（グラフィックインターフェイスなし）で起動します。
  • --no-sandbox：サンドボックスモードを無効にします。
• firefox
  • -p <profile>：Firefoxのプロファイルパスを指定します。
• webkit
  • --remote-debugging：リモートデバッグ機能を有効にします。

Browser Playgroundsのコマンドリスト

以下は、PlaywrightがサポートするBrowser Playgroundsのコマンドリストです。

基本操作

• browserSnapshot：現在のページのアクセシビリティスナップショットを取得します。これを使用することで、後続の操作がより効率的になります。
• browserTakeScreenshot：現在のページのスクリーンショットを撮ります。このスクリーンショットを基に操作を実行することはできません。操作を行うには、browserSnapshot を使用してください。

ファイルとメディア

• browserFileUpload：指定された場所にファイルをアップロードします。
  • パラメータ：paths（配列）— アップロードするファイルの絶対パス。1つまたは複数のファイルを指定できます。
• browserPdfSave：ページをPDFファイルとして保存します。
  • パラメータ：なし。

ナビゲーション

• browserNavigate：指定されたURLに移動します。
  • パラメータ：url（文字列）— 移動先のURL。
• browserNavigateBack：前のページに戻ります。
  • パラメータ：なし。
• browserNavigateForward：次のページに進みます。
  • パラメータ：なし。

キーボード操作

• browserPressKey：キーボードの特定のキーを押します。
  • パラメータ：key（文字列）— 押すキーの名前または生成される文字。例：ArrowLeft または a。

コンソール

• browserConsoleMessages：すべてのコンソールメッセージを返します。
  • パラメータ：なし。

待機と閉じる

• browserWait：指定された時間（秒）待機します。
  • パラメータ：time（数値）— 待機する時間。最大10秒まで指定できます。
• browserClose：現在のページを閉じます。
  • パラメータ：なし。