命令列選項

概觀

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 以「快速失敗」模式執行：如果無法啟動測試套件，則會中止其餘測試。
--list-files 顯示專案中存在的檔案清單。
標籤與篩選
--group -g 僅執行指定的群組或多個 (以逗號分隔) 測試 (子資料夾)。測試會透過放置在相同的子資料夾中來進行分組。
--skipgroup -s 跳過一個或多個 (以逗號分隔) 測試群組。
--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 允許指定要從目前檔案執行的哪個 Story (使用 Storybook 或以元件 Story 格式編寫的 JSX 時)。
--preview 用於預覽元件 Story/測試；在掛載元件後自動暫停測試執行。
資訊與說明
--help -h 顯示此說明。
--version -v 顯示版本號碼

建議內容