命令行

介绍

以下是命令行中可用的最常见选项。

• 运行所有测试

  npx剧作家测试

• 运行单个测试文件

  npx剧作家测试测试/todo-page.spec.ts

• 运行一组测试文件

  npx剧作家测试测试/待办页/测试/登陆页/

• 运行具有我的特异性或my-spec-2型在文件名中

  npx剧作家测试my-spec my-spec-2

• 运行my-spect.ts第42行中的测试

  npx剧作家测试我的谱：42

• 运行标题为的测试

  npx剧作家测试 -克 “添加待办事项”

• 在头戴式浏览器中运行测试

  npx剧作家测试 --头部

• 针对特定项目运行所有测试

  npx剧作家测试 --项目=铬

• 禁用并行化

  npx剧作家测试 --工人=1

• 选择一个记者

  npx剧作家测试 --记者=点

• 在调试模式下运行剧作家检查员

  npx剧作家测试 --调试

• 在交互式UI模式下运行测试，内置监视模式（预览）

  npx剧作家测试 --用户界面

• 寻求帮助

  npx剧作家测试 --帮助

参考

完整的剧作家测试选项集可在配置文件。可以将以下选项传递到命令行并优先于配置文件：

选项	说明
非选项参数	每个参数都被视为与完整测试文件路径匹配的正则表达式。只执行与模式匹配的文件中的测试。特殊符号，如$或*应该用\。在许多外壳/终端中，您可能需要引用参数。
-c<文件>或--配置<文件>	配置文件。如果未通过，则默认为编剧.config.ts或编剧.config.js在当前目录中。
--调试	与剧作家检查员一起运行测试。的快捷方式PWDEBUG=1环境变量和--timeout=0--max-failures=1--head--workers=1选项。
--故障检修-故障测试	包含片状测试的测试运行失败。默认情况下，失败的测试被视为成功。
--禁止地	是否不允许仅测试。对CI有用。
--全局超时<数字>	整个测试运行的总超时（毫秒）。默认情况下，没有全局超时。了解有关的更多信息各种超时.
-g<希腊语>或--希腊语<希腊语>	仅运行与此正则表达式匹配的测试。例如，这将运行'应添加到购物车'当通过时-g“添加到购物车”。将根据由项目名、测试文件名、，测试描述标题（如有）、测试标题和所有测试标签，用空格隔开，例如。铬my-test.spec.ts my-suite my-test@烟雾。该筛选器不适用于依赖项项目的测试，即Playwright仍将运行来自的所有测试项目相关性.
--grep-反转	仅运行测试不匹配此正则表达式。与…相反--格雷普。该筛选器不适用于依赖项项目的测试，即Playwright仍将运行来自的所有测试项目相关性.
--头部	在有标题的浏览器中运行测试。对调试有用。
--忽略快照	是否忽略快照。当已知快照预期不同时，使用此选项，例如针对Windows屏幕快照在Linux上运行测试。
--最后一次失败	仅重新运行故障。
--列表	列出所有测试，但不要运行它们。
--最大故障数<N>或-x个	在第一个之后停止N个测试失败。经过-x个第一次失败后停止。
--无步数	忽略项目之间的依赖关系，并表现为未指定依赖关系。
--输出<目录>	测试生成的工件的目录，默认为测试结果.
--无测试通过	当找不到文件时，允许测试套件通过。
--项目<名称>	仅从指定的项目，支持“*”通配符。默认为运行配置文件中定义的所有项目。
--安静	是否从测试中取消显示stdout和stderr。
--每次重复<N>	运行每个测试N个次，默认为一次。
--记者<记者>	选择记者：极简主义者点，简明扼要线或详细信息列表。请参阅记者了解更多信息。您还可以将路径传递给自定义报告程序文件。
--重试次数<次数>	最大数量重试次数对于片状测试，默认为零（无重试）。
--分片<分片>	碎片测试并只执行表单中指定的选定碎片当前/全部，例如，基于13/5.
--超时＜数字＞	每个测试的最大超时时间（毫秒）默认为30秒。了解有关的更多信息各种超时.
--跟踪<模式>	强制跟踪模式，可以是在,远离的,第一次重试,全部重试,保持器开启故障
--更新快照或-u个	是否更新快照与实际结果进行比较，而不是进行比较。当快照期望值发生变化时，请使用此选项。
--工人<人数>或-j<数字>	在中运行的最大并发工作进程数平行.