跳过主要内容
版本:27.2

Jest CLI选项

开玩笑命令行运行程序有许多有用的选项。你可以跑笑话——帮助亚搏取款查看所有可用选项。下面显示的许多选项也可以一起使用,以完全按照您想要的方式运行测试。杰斯特的每一个人配置也可以通过CLI指定选项。

以下是简要概述:

从命令行运行

运行所有测试(默认):

开玩笑

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

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

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

开玩笑

运行与路径/ / fileA.js路径/to/fileB.js

jest——findRelatedTests path/to/fileA.js . path/to/fileB.js . path

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

规格名称

观察运行模式:

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

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

与纱线一起使用

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

而不是:

开玩笑 “选择器”

您可以使用:

纱线 测试 -u-t “选择器”

与npm脚本一起使用

如果你开玩笑npm试验,仍然可以通过插入命令行参数来使用命令行参数--之间npm试验还有那些开玩笑的论点。

而不是:

开玩笑 “选择器”

您可以使用:

npm 测试 - - - - u - t “选择器”

Camelcase&args支持

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

开玩笑——收集报道
笑话——collectCoverage

参数也可以混合使用:

笑话——update-snapshot detectOpenHandles

选项

注意:CLI选项优先于配置


参考

jest

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

——保释

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

--缓存

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

如果要检查缓存,请使用--showConfig看看缓存目录值。如果需要清除缓存,请使用--clearCache

--使用祖先更改文件

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

——changedSince

运行与所提供的分支或提交哈希后的更改相关的测试。如果当前分支已偏离给定分支,则仅测试本地所做的更改。行为类似于——onlyChanged

- - - ci

当提供此选项时,Jest将假定它正在CI环境中运行。这将更改遇到新快照时的行为。与自动存储新快照的常规行为不同,它将无法通过测试,并且需要使用Jest运行——updateSnapshot

--clearCache

删除Jest缓存目录,然后在不运行测试的情况下退出。将删除缓存目录如果传递了该选项,或Jest的默认缓存目录。可以通过调用开玩笑——showConfig注意:清除缓存将降低性能。

——collectCoverageFrom = <水珠>

相对于rootDir匹配需要从中收集覆盖率信息的文件。

--颜色

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

——配置= <路径>

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

--覆盖率[=]

别名:--收集保险.指示应该收集测试覆盖率信息并在输出中报告。选择性地传递布尔> <覆盖配置中设置的选项。

--Coverage provider=

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

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

——调试

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

——detectOpenHandles

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

--环境=

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

——errorOnDeprecated

使调用已弃用的api抛出有用的错误消息。亚搏取款有助于简化升级过程。

——扩大

别名:-e. 使用此标志可显示完全差异和错误,而不是面片。

——过滤器= <文件>

导出筛选函数的模块的路径。此方法接收测试列表,可对其进行操作以排除运行中的测试。当与测试基础结构结合使用以筛选已知已损坏的测试时,此方法尤其有用。

--findRelatedTests

查找并运行包含以空格分隔的源文件列表(作为参数传入)的测试。用于预提交钩子集成,以运行所需的最少测试量。可以与——覆盖要包含源文件的测试覆盖率,请不要重复--收藏需要辩论。

--强制退出

在所有测试完成运行后强制退出Jest。当测试代码设置的资源无法充分清理时,这非常有用。注意:这个功能是一个逃生口。如果Jest在测试运行结束时没有退出,这意味着外部资源仍然被占用,或者代码中的计时器仍然挂起。建议在每次测试后关闭外部资源,以确保Jest可以干净地关闭。您可以使用——detectOpenHandles来帮我亚搏取款们找到它

--亚搏取款帮助

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

--初始化

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

——injectGlobals

插入Jest的globals(预料测试描述beforeEach等等)融入全球环境。如果你把它设为错误的,你应该从@玩笑/全球,例如。

进口 预料 开玩笑 测试 从…起 “@jest/globals”
开玩笑 useFakeTimers
测试 “一些测试” =>
预料 日期 现在 托比 0

注意:仅使用默认设置支持此选项玩笑马戏团测试运行器。

--json

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

--outputFile=

--json选项。返回的JSON结构记录在测试结果处理器

--最后提交

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

--列表测试

列出所有JSON测试,Jest将在给定参数的情况下运行这些测试,并退出。这个可以和--findRelatedTests了解Jest将运行哪些测试。

——logHeapUsage

在每次测试后记录堆使用情况。用于调试内存泄漏。一起使用--runInBand--暴露gc在节点。

全国矿工工会——maxConcurrency = < >

防止Jest同时执行超过指定数量的测试。仅影响使用test.concurrent

--maxWorkers=|

别名:-w。指定工作线程池为运行测试而生成的最大工作线程数。在单次运行模式下,此值默认为计算机上可用的内核数减去主线程的一个。在监视模式下,此值默认为计算机上可用内核数的一半,以确保Jest不引人注意,并且不会将计算机磨成一个大的规模在资源有限的环境(如CIs)中调整此设置可能会很有用,但默认设置应该适合大多数用例。

对于具有可变cpu的环境,可以使用基于百分比的配置:——maxWorkers = 50%

--背迹

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

--通知

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

——onlyChanged

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

--通行证

当没有找到文件时,允许测试套件通过。

--项目

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

——记者

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

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

--根

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

--runInBand

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

——selectProjects < project1 >…< projectN >

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

——runTestsByPath

仅运行指定了精确路径的测试。

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

--setupTestFrameworkScriptFile=

在每次测试之前运行一些代码以配置或设置测试框架的模块的路径。请注意,在测试过程中不会模拟由安装脚本导入的文件。

--showConfig

打印Jest配置,然后退出。

——沉默

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

--testNamePattern=

别名:-t.只运行名称与正则表达式匹配的测试。例如,假设您只想运行与授权相关的测试,这些测试的名称类似于GET /api/post with auth,则可以使用jest-t=auth

注意:正则表达式是根据全名匹配的,全名是测试名和它周围的所有描述块的组合。

——testLocationInResults

添加一个地方现场测试结果。如果想要报告报告器中测试的位置,这很有用。

请注意,也就是,线不是。

“栏目” 4
“行” 5

--testPathPattern=

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

--testPathIgnorePatterns=|[array]

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

要作为数组传递,请使用转义括号和空格分隔的正则表达式,例如\ (/ node_modules / /测试/ e2e / \). 或者,您可以通过将regexp组合到单个regexp中来省略括号,如/ node_modules / | /测试/ e2e /.这两个例子是等价的。

--testRunner=

允许您指定一个自定义测试运行器。

--testSequencer=

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

--testTimeout=

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

——updateSnapshot

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

——useStderr

将所有输出转移到stderr。

——详细

使用测试套件层次结构显示单个测试结果。

——版本

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

——看

监视文件的更改,并重新运行与更改的文件相关的测试。如果要在文件更改后重新运行所有测试,请使用——watchAll选项。

——watchAll

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

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

——守望

是否使用守望对文件爬行。默认为符合事实的. 禁用使用--没有看守

最近更新日期通过四门Bekkhus