mablを初めて使用し、既存のPlaywrightテストを活用したい場合は、mablの高度なテスト機能を直接Playwrightテストスイートに統合するか、Playwrightテストをmablに移行することができます。以下のステップに従って、Playwrightテストをmabl CLIを通じてmablにインポートしてください。
開始する前に
mabl CLIのインポーターツールは、元のPlaywrightテストにできるだけ近いmablテストを作成することを目指しています。ただし、次のような制限事項があります。
- 変数、コードブロック、IFステートメント、ループは、インポートセッション中に移行されません。
- mablテストは、Playwrightの配列アサーションまたは正規表現を使用するアサーションをサポートしていません。
Playwrightテストの移行を行う場合は、この記事の末尾にあるテストの更新の推奨手順を実行して、mablテストを正常に機能させるようにしてください。
ステップ1: mabl CLIのインストール
お使いのマシンにmabl CLIがインストールされていない場合は、次のコマンドを実行します。
npm install -g @mablhq/mabl-cli
mabl CLIがすでにインストールされている場合は、次のコマンドを実行して最新バージョンに更新します。
npm install -g @mablhq/mabl-cli@latest
ステップ2: mabl CLIへのログイン
次のコマンドを実行して、mabl CLIにログインします。
mabl auth login
このコマンドを実行すると、mablのログインページがブラウザーウィンドウに表示されます。認証を完了するには、次の手順を実行します。
- 通常の手段 (ユーザー名とパスワード、Google認証システム、またはSSO) を使用してmablにログインします。
- ブラウザーウィンドウから認証コードをコピーします。
- 認証コードをmabl CLIに貼り付けます。
- Enterキーを押すと、ログインが完了します。
ステップ3: テストのインポート
テストをインポートするには、mabl tests import playwrightコマンドを使用します。Playwrightテストは実行時にインポートするか、trace.zipファイルからインポートできます。
インポートオプションの一覧を確認するには、CLIでmabl tests import playwright -hコマンドを実行するか、mabl CLIでのテストのインポートに関する記事を参照してください。
実行時のインポート
実行時にPlaywrightテストをインポートするには、--pathオプションを指定してmabl tests import playwrightコマンドを実行してください。mabl CLIがPlaywrightプロジェクトのbaseURLをmablテスト内のアプリケーションURLに変換できるように、オプションの--projectフラグを含めることをお勧めします。
mabl tests import playwright --path {path-to-playwright-tests} --project {project-path}mabl CLIは、お使いのマシンにインストールされているPlaywrightバージョンを使ってPlaywrightテストを実行します。すべてのテストが成功したら、インポートセッションを完了するため、次のオプションのいずれかを選択するように求められます。
- Discard the test - テストを破棄する
- Run test to activate auto-heal - テストを実行して自動修復を有効にする
- Save the test - テストを保存する
- View the test description - テストの説明を表示する
自動修復を有効にする
mablの検索戦略の利点を最大限に活用するために、「Run tests and activate auto-heal」を選択することを強くお勧めします。これには、自動修復、検索の設定、およびインテリジェント待機が含まれます。このオプションは、mablでテストをローカルに実行し、カスタムPlaywrightセレクターを自動修復が有効なmablステップに変換します。
「Run tests and activate auto-heal」を選択しない場合、ページ要素を操作するすべてのステップはmablのカスタム検索ステップに変換されます。
トレースファイルからのインポート
trace.zipファイルから個別のPlaywrightテストをインポートするには、次のように、--trace-fileオプションを指定して、mabl tests import playwrightコマンドを実行します。
mabl tests import playwright --trace-file {path-to-trace-file} --project {project-path}trace.zipファイルのディレクトリから複数のPlaywrightテストをインポートするには、次のように、--traces-pathオプションを指定して、mabl tests import playwrightコマンドを実行します。
mabl tests import playwright --traces-path {path-to-trace-directory} --project {project-path}ステップ4: mablでのテストの更新
mablで移行したテストを成功させるために、サポートされていないステップがないか確認してください。Playwrightテストにmablでサポートされていないステップが含まれる場合、サポートされていないステップはEchoステップになるか、テストの最後の説明に記載されます。
サポートされていないステップを含む移行されたPlaywrightテスト
フィードバックの提供
Playwrightのインポートコマンドは試験的サービスです。mabl Product Portalを通じて、この機能についてのフィードバックをお寄せください。