メインコンテンツへスキップ

コマンドライン

概要​

コマンドラインで利用できる最も一般的なオプションは以下のとおりです。

  • すべてのテストを実行

    npx playwright test

  • 単一のテストファイルを実行

    npx playwright test tests/todo-page.spec.ts

  • 一連のテストファイルを実行

    npx playwright test tests/todo-page/ tests/landing-page/

  • ファイル名にmy-specまたはmy-spec-2を含むファイルを実行

    npx playwright test my-spec my-spec-2

  • my-spec.tsの42行目にあるテストを実行

    npx playwright test my-spec.ts:42

  • タイトルでテストを実行

    npx playwright test -g "add a todo item"

  • ヘッド付きブラウザでテストを実行

    npx playwright test --headed

  • 特定のプロジェクトに対してすべてのテストを実行

    npx playwright test --project=chromium

  • 並列実行を無効にする

    npx playwright test --workers=1

  • レポーターを選択

    npx playwright test --reporter=dot

  • Playwright Inspectorでデバッグモードで実行

    npx playwright test --debug

  • インタラクティブなUIモードで、組み込みのウォッチモードでテストを実行（プレビュー）

    npx playwright test --ui

  • ヘルプを参照

    npx playwright test --help

リファレンス​

Playwright Testオプションの完全なセットは、設定ファイルで利用可能です。以下のオプションはコマンドラインに渡すことができ、設定ファイルよりも優先されます

オプション説明
非オプション引数各引数は、完全なテストファイルのパスに一致する正規表現として扱われます。パターンに一致するファイルからのテストのみが実行されます。$や*のような特殊記号は\でエスケープする必要があります。多くのシェル/ターミナルでは、引数を引用符で囲む必要がある場合があります。
-c <file> または --config <file>設定ファイル、またはオプションの「playwright.config.{m,c}?{js,ts}」を含むテストディレクトリ。現在のディレクトリのplaywright.config.tsまたはplaywright.config.jsがデフォルトです。
--debugPlaywright Inspectorでテストを実行します。PWDEBUG=1環境変数と--timeout=0 --max-failures=1 --headed --workers=1オプションのショートカットです。
--fail-on-flaky-tests不安定なテストとしてフラグが付けられたテストがあれば失敗します（デフォルト：false）。
--forbid-onlytest.onlyが呼び出された場合に失敗します（デフォルト：false）。CIで役立ちます。
--fully-parallelすべてのテストを並列で実行します（デフォルト：false）。
--global-timeout <timeout>このテストスイートが実行できる最大時間（ミリ秒単位）（デフォルト：無制限）。
-g <grep> または --grep <grep>この正規表現に一致するテストのみを実行します（デフォルト：「.*」）。
-gv <grep> または --grep-invert <grep>この正規表現に一致しないテストのみを実行します。
--headedヘッド付きブラウザでテストを実行します（デフォルト：ヘッドレス）。
--ignore-snapshotsスクリーンショットとスナップショットの期待値を無視します。
--last-failed失敗したテストのみを再実行します。
--listすべてのテストを収集して報告しますが、実行はしません。
--max-failures <N> または -x最初のN個の失敗後に停止します。-xを渡すと、最初の失敗後に停止します。
--no-depsプロジェクトの依存関係を実行しません。
--output <dir>出力アーティファクト用のフォルダ（デフォルト：「test-results」）。
--only-changed [ref]'HEAD'と'ref'の間で変更されたテストファイルのみを実行します。デフォルトでは、コミットされていないすべての変更を実行します。Gitのみをサポートしています。
--pass-with-no-testsテストが見つからなかった場合でも、テスト実行が成功します。
--project <project-name...>指定されたプロジェクトのリストからテストのみを実行します。`*`ワイルドカードをサポートしています（デフォルト：すべてのプロジェクトを実行）。
--quietstdioを抑制します。
--repeat-each <N>各テストをN回実行します（デフォルト：1）。
--reporter <reporter>使用するレポーター。カンマ区切りで、「dot」、「line」、「list」などが可能です（デフォルト：「list」）。カスタムレポーターファイルへのパスを渡すこともできます。
--retries <retries>不安定なテストの最大リトライ回数。0はリトライなし（デフォルト：リトライなし）。
--shard <shard>テストをシャーディングし、選択されたシャードのみを実行します。「current/all」の形式で指定し、1から数えます（例：「3/5」）。
--timeout <timeout>テストのタイムアウトしきい値をミリ秒で指定します。0は無制限（デフォルト：30秒）。
--trace <mode>トレースモードを強制します。「on」、「off」、「on-first-retry」、「on-all-retries」、「retain-on-failure」、「retain-on-first-failure」が可能です。
--tsconfig <path>すべてのインポートファイルに適用される単一のtsconfigへのパス（デフォルト：各インポートファイルに対してtsconfigを個別に検索）。
--uiインタラクティブなUIモードでテストを実行します。
--ui-host <host>UIを提供するホスト。このオプションを指定すると、ブラウザのタブでUIが開きます。
--ui-port <port>UIを提供するポート。0は任意の空きポート。このオプションを指定すると、ブラウザのタブでUIが開きます。
-u または --update-snapshots [mode]スナップショットを実際の結果で更新します。可能な値は「all」、「changed」、「missing」、「none」です。フラグなしでテストを実行するとデフォルトで「missing」になり、フラグを指定しても値がない場合はデフォルトで「changed」になります。
--update-source-method [mode]スナップショットを実際の結果で更新します。可能な値は「patch」（デフォルト）、「3way」、「overwrite」です。「patch」は、後でソースコードを更新するために使用できる統合差分ファイルを作成します。「3way」は、ソースコードにマージ競合マーカーを生成します。「overwrite」は、新しいスナップショット値でソースコードを上書きします。
-j <workers> または --workers <workers>同時ワーカー数または論理CPUコアの割合。単一ワーカーで実行するには1を使用します（デフォルト：50%）。
-x最初の失敗後に停止します。