mabl CLIには、次のようにテストのアドホック実行コマンドが2種類あります。
mabl tests run
: ローカルでのアドホック実行をトリガーmabl tests run-cloud
: クラウドでのアドホック実行をトリガー
mabl CI runner
mabl CI Runnerを使用して、自社のCI/CDコンテナーまたはサーバーでmabl CLIからテストを実行することもできます。この方法によるテストの実行の詳細については、こちらをクリックしてください。
mabl tests run
mabl tests run
コマンドは、ローカルでのアドホック実行をトリガーし、ターミナルウィンドウに出力と結果を表示します。
オプション
オプション | 詳細 |
---|---|
--id |
実行するテストのID |
--run-id |
設定を取得するテスト実行のID |
--from-plan-id |
テスト実行のリストを取得するためのプランID。注意: --from-plan-id オプションでテストを実行すると、プラン実行ではありません。ステージ、ブラウザの設定、または共有変数などの高度なプラン構成は適用されません.。 |
--mabl-branch |
テストを実行するmablブランチ。 |
--branch-changes-only |
--mabl-branch オプションとともに使用します。指定したブランチにないテストを除外します。デフォルト値はfalseです。 |
--labels |
スペース区切りのラベルのリストに一致するテストを実行します。 |
--exclude-labels |
スペース区切りのラベルのリストに一致するテストを除外します。 |
--environment-id , -e |
実行するMablの環境を指定します。テストが正しい環境変数と最新の検索情報で実行されるように指定してください。注意: 環境を設定してもデフォルトのURLは上書きされません。URLを上書きするには、--url または-uオプションを使用してください。 |
--locale |
テストを実行するロケール。例: "ja" |
--timezone |
テストを実行するためのタイムゾーンの識別子。例:Japan/Tokyo |
--width |
ブラウザーの幅をピクセル単位で設定します。 |
--height |
ブラウザーの高さをピクセル単位で設定します。 |
--url , -u |
mablテストを実行するURL。 |
--credentials-id , --creds |
テストの実行に使用するクレデンシャル。 |
--data-table-id |
DataTable IDのすべてのシナリオを使用してテストを実行します。 |
--scenario-id |
特定のDataTableシナリオを使用してテストを実行します。 |
--basic-auth-credentials-id , --basic-creds |
テストの実行に使用する基本認証クレデンシャル。 |
--headless |
ブラウザーウィンドウを開かずに、バックグラウンドでテストを実行します。デフォルト値はfalseです。 |
--highlights |
エレメントを操作する前にエレメントを強調表示します。強調表示によって各ステップにわずかな遅延が生じます。デフォルト値はfalseです。 |
--keep-browser-open |
テスト終了時にブラウザーが閉じないようにします。デフォルト値はfalseです。 |
--enable-browser-extensions |
ChromeとEdgeのブラウザー拡張機能を有効にします。デフォルト値はfalseです。 |
--http-headers |
ブラウザーリクエストに追加するHTTPヘッダー。複数指定する場合はスペースで区切ります。例: "x-header: foo" |
--user-agent |
カスタムユーザーエージェントをエミュレートします。 |
--interaction-speed |
mablでWebページを操作する速度を設定します。このオプションを指定した場合、テスト実行の設定はオーバーライドされます。 |
--from-plan-id
--from-plan-id
オプションはプランの情報を単なるグループ化しています。これはプランの実行ではありません:
- プランIDに関連付けられたテストは、mablアプリのプラン詳細ページに表示されるのと同じ順番で順次実行されます。
- mabl CLIはステージ、ブラウザの設定、共有変数などの高度なプラン構成を適用しません。
- 全てのテストは、プランのアプリケーションと環境に関連付けられた URL である、同じベース URL を使用します。プランが複数のURLで設定されている場合、mabl CLIはそれらのURLの1つを使用します。
--url
オプションを含めると、グループ内のすべてのテストがこのURLを使用します。
例
# Trigger a headless local test run
mabl tests run --id <テストid> --headless true
# Trigger a local test run for tests matching a set of labels and exclude tests with the label "cleanup"
mabl tests run --labels smoke needs-review --exclude-labels cleanup
# Trigger a local test run for a specific DataTable scenario
mabl tests run --id <テストid> --scenario-id <シナリオid>
制限事項
- サポート対象ブラウザー: ローカルでのテスト実行では、ローカルマシンにインストールされたChromeブラウザーが使用されます。コマンド
mabl config set browser.path <ブラウザーのパス></ブラウザーのパス>
を使用すると、ブラウザーのパスを、Microsoft Edgeなどの別のChromiumブラウザーのパスに更新することができます。ただし、ブラウザーパスの設定を誤ると、ローカルでのテスト実行が行えなくなる可能性があるため、注意してください。 - 順次実行のみ: ローカルでのテスト実行は並列実行をサポートしていません。
mabl tests run-cloud
mabl tests run-cloud
コマンドは、クラウドでのアドホック実行をトリガーし、テスト出力へのリンクをmablアプリケーションで提供します。
オプション
オプション | 詳細 |
---|---|
--id |
実行するテストのID |
--deployment-id , -d |
mablテストを実行するデプロイ |
--url , -u |
app-url のエイリアス |
--app-url |
mablテストを実行するWebアプリケーションのURL |
--api-url |
mablテストを実行するAPIのURL |
--basic-auth-credentials-id , --basic-creds |
テストの実行に使用する基本認証クレデンシャル。 |
--browsers , -b |
テストを実行するブラウザー。複数指定する場合はスペースで区切ります。デフォルトは "chrome" です。 |
--api-key , -k |
スクリプトでコマンドを認証するためのAPIキー。 |
--mabl-branch |
テストを実行するmablブランチ |
--branch-changes-only |
--mabl-branch オプションとともに使用します。指定したブランチにないテストを除外します。デフォルト値はfalseです。 |
--revision , --rev |
テスト実行を特定のgitコミットハッシュまたはリビジョンIDに関連付けます。 |
--labels |
スペース区切りのラベルのリストに一致するテストを実行します。 |
--exclude-labels |
スペース区切りのラベルのリストに一致するテストを除外します。 |
--application-id , -a |
テストを実行するmablアプリケーション。 |
--environment-id , -e |
実行するMablの環境を指定します。テストが正しい環境変数と最新の検索情報で実行されるように指定してください。注意: 環境を設定してもデフォルトのURLは上書きされません。URLを上書きするには、--url または-uオプションを使用してください。 |
--credentials-id , --creds |
テストの実行に使用するクレデンシャルID。 |
--locale |
テストを実行するロケール。例: "ja" |
--timezone-id |
テストを実行するためのタイムゾーンの識別子。例:Japan/Tokyo |
--prompt |
テストを実行する前に、実行するかどうかを確認するメッセージを表示します。このフラグは、--labels オプションを使用して複数のテストをトリガーするテスト実行にのみ適用されます。デフォルト値はtrue です。 |
--no-prompt , --yes |
テストを実行する前に、実行するかどうかを確認するメッセージを表示します。このフラグは、--labels オプションを使用して複数のテストをトリガーするテスト実行にのみ適用されます。 |
例
# Trigger cloud runs of tests associated with a label and skip the confirmation prompt
mabl tests run-cloud --labels smoke needs-review --no-prompt
# Trigger cloud runs of a test on Chrome and Edge
mabl tests run-cloud --id <テストid> --browsers chrome edge