跳到主要内容
版本:27.0

Jest CLI选项

这个开玩笑命令行运行程序有许多有用的选项。你可以跑了开玩笑——救命亚搏取款查看所有可用选项。下面显示的许多选项也可以一起使用,以您想要的方式运行测试。每一个小丑配置也可以通过CLI指定选项。

以下是简要概述:

从命令行运行#

运行所有测试(默认):

开玩笑

仅运行使用模式或文件名指定的测试:

开我的玩笑 #或者
jest路径/to/my-test.js

基于hg/git(未提交的文件)运行与已更改文件相关的测试:

开玩笑

运行与相关的测试路径/to/fileA.js路径/to/fileB.js:

jest—findRelatedTests路径/to/fileA.js路径/to/fileB.js

运行与此规范名称匹配的测试(与中的名称匹配描述测试,基本上)。

规格名称

运行监视模式:

开玩笑——看 #默认情况下运行jest-o
开玩笑——守望 #运行所有测试

监视模式还允许指定文件的名称或路径,以集中于一组特定的测试。

与纱线一起使用#

如果你开玩笑的话纱线测试,可以直接将命令行参数作为Jest参数传递。

而不是:

开玩笑 = “颜色选择器”

您可以使用:

纱线 测试 -u-t型 = “颜色选择器”

与npm脚本一起使用#

如果你开玩笑的话npm测试,仍然可以通过插入--之间npm测试开玩笑的争论。

而不是:

开玩笑 = “颜色选择器”

您可以使用:

npm公司 测试 ---u-t型 = “颜色选择器”

Camelcase和args支持#

Jest支持camelcase和虚线arg格式。以下示例的结果相同:

开玩笑——收集报道
开玩笑--收集报道

参数也可以是混合的:

jest—更新快照—detectOpenHandles

选项#

注意:CLI选项优先于配置.


参考#

jest#

当你跑的时候开玩笑对于参数,该参数将被视为正则表达式,以便与项目中的文件匹配。可以通过提供模式来运行测试套件。只有模式匹配的文件才会被拾取和执行。根据终端的不同,您可能需要引用以下参数:开玩笑说“我的复杂模式”. 在Windows上,您需要使用/作为路径分隔符或转义符\作为\\.

--保释#

别名:-b类. 立即退出测试套件N失败的测试套件数。默认为1..

--缓存#

是否使用缓存。默认为true。使用禁用缓存--无缓存.注意:只有在遇到与缓存相关的问题时才应禁用缓存。平均而言,禁用缓存会使Jest至少慢两倍。

如果要检查缓存,请使用--显示配置再看看缓存目录价值观。如果需要清除缓存,请使用--清除缓存.

--changedFileWithAscentor#

运行与当前更改和上次提交中所做更改相关的测试。行为类似于--仅更改.

--变化自#

运行与所提供的分支或提交哈希之后的更改相关的测试。如果当前分支已从给定分支发散,则只测试本地所做的更改。行为类似于--仅更改.

--ci公司#

当提供此选项时,Jest将假定它正在CI环境中运行。这将更改遇到新快照时的行为。与自动存储新快照的常规行为不同,它将使测试失败,并要求使用Jest运行--更新快照.

--清除缓存#

删除Jest缓存目录,然后退出而不运行测试。将删除缓存目录如果传递了该选项,则返回Jest的默认缓存目录。可以通过调用jest—显示配置.注意:清除缓存会降低性能。

--collectCoverageFrom=#

一种相对于根目录匹配需要从中收集覆盖率信息的文件。

--颜色#

即使stdout不是TTY,也强制测试结果输出高亮显示。

--配置=<路径>#

别名:-c级. 指定如何查找和执行测试的Jest配置文件的路径。如果没有根目录如果在config中设置,则假定包含配置文件的目录为根目录为了这个项目。这也可以是Jest将用作配置的JSON编码值。

--覆盖率[=]#

别名:--收集覆盖范围. 指示应在输出中收集和报告测试覆盖率信息。可选通过<布尔值>覆盖配置中设置的选项。

--coverageProvider=#

指示应使用哪个提供程序为覆盖范围插入代码。允许值为巴别塔(默认)或v8发动机.

注意,使用v8发动机被认为是实验性的。这使用了V8的内置代码覆盖率,而不是基于Babel的覆盖率。它没有经过很好的测试,在Node的最后几个版本中也有改进。使用node的最新版本(本文撰写时的v14)将产生更好的结果。

--调试#

打印有关Jest配置的调试信息。

--探长手柄#

尝试收集和打印打开的句柄,以防止Jest干净地退出。在需要使用的情况下使用这个--强制退出为了让Jest退出去寻找原因。这意味着--跑步带,使测试连续运行。使用实现异步\u挂钩. 此选项会造成严重的性能损失,因此只能用于调试。

--环境=<环境>#

用于所有测试的测试环境。这可以指向任何文件或节点模块。示例:jsdom公司,节点路径/to/my-environment.js.

--预防性错误#

使调用不推荐的API抛出有用的错误消息。有助于简化升级过程。亚搏取款

--展开#

别名:-电子. 使用此标志可显示完全差异和错误,而不是修补程序。

--过滤器=<文件>#

导出过滤函数的模块的路径。此方法接收测试列表,可以对其进行操作以从运行中排除测试。当与测试基础设施结合使用以过滤已知损坏的数据时特别有用。

--findRelatedTests#

查找并运行包含以空格分隔的作为参数传入的源文件列表的测试。对于预提交钩子集成非常有用,可以运行最少的测试。可与配合使用--覆盖范围要包含源文件的测试覆盖率,请不要重复--收集覆盖范围需要论证。

--强制退出#

在所有测试完成运行后强制Jest退出。当测试代码设置的资源不能被充分清理时,这很有用。注意:此功能是一个逃生舱口。如果Jest在测试运行结束时没有退出,则意味着外部资源仍然保留在您的代码中,或者计时器仍然挂起。建议在每次测试后关闭外部资源,以确保Jest可以干净地关闭。你可以用--探长手柄帮助追亚搏取款查。

--亚搏取款救命#

显示帮助信息,类似亚搏取款于此页。

--初始化#

生成基本配置文件。根据你的项目,Jest会问你一些问题,这将有助于生成一个亚搏取款jest.config.js文件每个选项的简短描述文件。

--注射剂#

插入Jest的globals(期待,测试,描述,每次之前等)进入全球环境。如果你把这个设定为,您应该从导入@玩笑/全局,例如。

进口 { 期待 , 开玩笑 , 测试 } '@jest/globals' ;
开玩笑 . 使用计时器 ( ) ;
测试 ( '一些测试' , ( ) => {
期待 ( 日期 . 现在 ( ) ) . 托比 ( 0 ) ;
} ) ;

注意:只有使用默认值时才支持此选项玩笑马戏团测试跑步者。

--json文件#

以JSON格式打印测试结果。此模式将所有其他测试输出和用户消息发送到stderr。

--outputFile=#

--json文件也指定了选项。返回的JSON结构记录在测试结果处理器.

--上次提交#

运行上次提交时受文件更改影响的所有测试。行为类似于--仅更改.

--列表测试#

以JSON的形式列出Jest将在给定参数的情况下运行的所有测试,并退出。这可以与--查找最新测试了解Jest将运行哪些测试。

--日志页#

记录每次测试后的堆使用情况。用于调试内存泄漏。与…一起使用--跑步带--暴露gc在节点中。

--最大并发=#

防止Jest同时执行超过指定数量的测试。只影响使用测试并发.

--maxWorkers=|#

别名:-w型. 指定工作线程池将为运行测试生成的最大工作线程数。在单次运行模式下,这默认为计算机上可用的内核数减去主线程的1。在监视模式下,这默认为机器上可用内核的一半,以确保Jest不引人注目,并且不会使机器停止运行。在资源有限的环境(如CIs)中调整这一点可能很有用,但是缺省值对于大多数用例应该是足够的。

对于具有可变CPU的环境,可以使用基于百分比的配置:--最大工人数=50%

--无跟踪#

在测试结果输出中禁用堆栈跟踪。

--通知#

激活测试结果通知。当你不希望自己的意识能够专注于JavaScript测试之外的任何事情时,这是一个很好的选择。亚博串子容错怎么买

--仅更改#

别名:-o. 尝试根据当前存储库中已更改的文件来确定要运行的测试。只有在当前在git/hg存储库中运行测试并且需要静态依赖关系图(即,不需要动态依赖关系图)时才有效。

--带便笺的密码#

允许测试套件在找不到文件时通过。

--项目<路径n>#

从指定路径中找到的一个或多个项目运行测试;也采取路径球。此选项相当于项目配置选项。请注意,如果在指定路径中找到配置文件,全部的将运行这些配置文件中指定的项目。

--记者#

使用指定的报告程序运行测试。报告器选项无法通过CLI使用。多个记者的例子:

jest--reporters=“默认”--reporters=“jest junit”

--根#

Jest用于在中搜索文件的目录的路径列表。

--跑步带#

别名:-我. 在当前进程中连续运行所有测试,而不是创建运行测试的子进程的工作进程池。这对调试很有用。

--选择项目<项目n>#

只运行指定项目的测试。Jest使用属性显示名称在配置中标识每个项目。如果使用此选项,则应提供显示名称你所有的项目。

--运行测试路径#

只运行用精确路径指定的测试。

注意:默认的regex匹配在小规模运行时可以正常工作,但是如果提供了多个模式和/或针对大量测试,则会变得很慢。此选项替换regex匹配逻辑,从而优化Jest筛选特定测试文件所需的时间

--setupTestFrameworkScriptFile=#

模块的路径,该模块在每次测试之前运行一些代码来配置或设置测试框架。注意,安装脚本导入的文件在测试期间不会被模拟。

--显示配置#

打印Jest配置,然后退出。

--沉默#

防止测试通过控制台打印消息。

--testNamePattern=#

别名:-t型. 只运行名称与regex匹配的测试。例如,假设您只想运行与授权相关的测试,这些测试的名称如下“使用auth获取/api/posts”,则可以使用jest-t=认证.

注意:regex与全名匹配,全名是测试名及其周围所有描述块的组合。

--测试位置结果#

添加位置现场测试结果。如果您想在报告器中报告测试的位置,那么这将非常有用。

请注意索引为0,而线不是。

{
“列” : 4. ,
“行” : 5.
}

--testPathPattern=#

在执行测试之前与所有测试路径匹配的regexp模式字符串。在Windows上,您需要使用/作为路径分隔符或转义符\作为\\.

--testPathIgnorePatterns=|[数组]#

在执行测试之前,根据所有测试路径测试的单个或一组regexp模式字符串。与…相反--测试路径模式,它将仅使用与提供的regexp表达式不匹配的路径运行这些测试。

要作为数组传递,请使用转义括号和空格分隔的regexp,例如\(/node\u modules//tests/e2e/\). 或者,可以通过将regexp组合到单个regexp中来省略括号,如/节点|模块/|/测试/e2e/. 这两个例子是等价的。

--testRunner=#

用于指定自定义测试运行程序。

--testSequencer=#

用于指定自定义测试序列器。有关详细信息,请参阅相应配置属性的文档。

--测试超时=#

测试的默认超时(毫秒)。默认值:5000。

--更新快照#

别名:-u型. 使用此标志可重新记录此测试运行期间失败的每个快照。可以与测试套件模式或--测试名称模式重新录制快照。

--使用标准#

将所有输出转移到stderr。

--冗长的#

显示带有测试套件层次结构的单个测试结果。

--版本#

别名:-五. 打印版本并退出。

--观察#

监视文件的更改并重新运行与更改的文件相关的测试。如果要在文件更改后重新运行所有测试,请使用--监视球而不是选择。

--监视球#

监视文件的更改,并在发生更改时重新运行所有测试。如果只想重新运行依赖于已更改文件的测试,请使用--观察选项。

使用--watchAll=假明确禁用监视模式。请注意,在大多数CI环境中,这是自动为您处理的。

--看守人#

是否使用看守人用于文件爬网。默认为是的. 禁用使用--没有看守人.

上次更新时间通过西门别库斯