コマンドラインオプション

概要

Nightwatchテストランナーは、実行時に渡される多くのオプションをサポートしています。すべてを表示するには、次を実行します。

nightwatch --help

オプション


名前 短縮名 デフォルト 説明
メインオプション
--env -e デフォルト 使用するテスト環境 - `nightwatch.json` で定義されています
--config -c ./nightwatch.json 設定ファイルへのパス。`nightwatch.conf.js` または `nightwatch.json` が存在する場合、デフォルトで読み取られます。[設定](/gettingstarted/configuration/)セクションを確認してください。
--test -t 指定されたテストスイート/モジュールのみを実行します。デフォルトでは、ランナーは `src_folders` 設定フォルダとそのサブフォルダ内のすべてのテストを実行しようとします。
--testcase `--test` と一緒にのみ使用されます。現在のスイート/モジュールから指定されたテストケースを実行します。
--mocha テストランナーをMochaを使用するように設定します。
--timeout アサーションが失敗する前にアサーションを再試行するためのグローバルタイムアウトを設定します。さまざまなタイムアウト値は、[グローバル](/gettingstarted/concepts/#using-test-globals) セクションで定義されています。
--reuse-browser 個々のテストスイートを実行するために同じブラウザセッションを使用します（シリアルモードのみ）。
--workers 同時に実行されるテストファイルの最大数（デフォルト：CPUコア数、例：workers=4）
--serial テストを順番に実行します（並列モードを無効にします）。
--headless ブラウザ（ChromeまたはFirefox）をヘッドレスモードで起動します。
--devtools ブラウザ（Chrome、Edge、またはSafari）の起動時に自動的に開発ツールを開きます。
--verbose セッション中に拡張Seleniumコマンドログを表示します。
--fail-fast 「fail-fast」モードで実行します。テストスイートを開始できない場合、残りは中止されます。
--list-files プロジェクトに存在するファイルのリストを表示します。
タグとフィルタリング
--group -g 指定されたグループまたは複数の（カンマ区切り）テスト（サブフォルダ）のみを実行します。テストは、同じサブフォルダに配置することでグループ化されます。
--skipgroup -s 1つまたは複数の（カンマ区切り）テストグループをスキップします。
--filter -f テストファイルを読み込むときに使用するファイル名形式として、フィルター（glob式）を指定します。
--tag -a タグでテストモジュールをフィルタリングします。指定されたタグを持つテストのみが読み込まれます。
--skiptags 指定されたタグを持つテストをスキップします。
再試行
--retries 失敗またはエラーが発生したテストケースを、指定された回数まで再試行します。テストケースの再試行は、`beforeEach` および `afterEach` フックも再試行します（存在する場合）。
--suiteRetries 失敗またはエラーが発生したテストスイート（テストモジュール）を、指定された回数まで再試行します。テストスイートの再試行は、テストスイートに定義されている場合、`before` および `after` フックも再試行します（それぞれグローバルな beforeEach および afterEach に加えて）。
レポート
--reporter -r junit 定義済みのレポーターの名前（例：junit）または使用するカスタムレポーターファイルへのパス。

カスタムレポーターインターフェースは次のようになります。
module.exports = {
write(results, options, done) {
  done();
}
};
--output -o tests_output JUnit XMLレポートが保存される場所。
--open テスト実行の最後に、デフォルトのブラウザで生成されたHTMLレポートを開きます。
コンポーネントテスト
--debug コンポーネントのマウント後にテスト実行を自動的に一時停止し、NightwatchデバッグREPLインターフェースを開きます。
--story 現在のファイルから実行するストーリーを指定できます（Storybookまたはコンポーネントストーリー形式で記述されたJSXを使用する場合）。
--preview コンポーネントストーリー/テストをプレビューするために使用されます。コンポーネントのマウント後にテスト実行を自動的に一時停止します。
情報とヘルプ
--help -h このヘルプを表示します。
--version -v バージョン番号を表示します

おすすめコンテンツ