命令行选项

概述

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 允许从当前文件指定要运行的哪个故事（在使用 Storybook 或以组件故事格式编写的 JSX 时）。
--preview 用于预览组件故事/测试；在挂载组件后自动暂停测试执行。
信息 & 帮助
--help -h 显示此帮助。
--version -v 显示版本号

推荐内容