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 tests import playwright --path <path-to-playwright-tests> --project <project-path>
推奨
mabl CLIで--projectオプションを追加すると、PlaywrightプロジェクトのbaseURLをmablテストのアプリケーションURLに変換できます。
mabl CLIは、お使いのマシンにインストールされているPlaywrightバージョンを使ってPlaywrightテストを実行します。すべてのテストが成功したら、インポートセッションを完了するため、次のオプションのいずれかを選択するように求められます。
- テストの説明を表示する
- テストをローカルで実行する
- テストを保存する
- テストを破棄して終了する
トレースファイルからのインポート
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のカスタム検索ステップに変換されます。自動修復、検索の設定、インテリジェント待機などのmablの検索ストラテジーを最大限に活かすには、インポートしたカスタム検索ステップをmabl Trainerで記録したアクションに置き換えることを強くお勧めします。
フィードバックの提供
Playwrightのインポートコマンドは試験的サービスです。mabl Product Portalを通じて、この機能についてのフィードバックをお寄せください。