类:Jasmine

Jasmine(options)

配置、构建和执行 Jasmine 测试套件。
另请参阅 ParallelRunner,它提供平行执行的同等功能。

构造函数

new Jasmine(options)

参数
名称 类型 描述
options JasmineOptions | undefined
示例
const Jasmine = require('jasmine');
const jasmine = new Jasmine();

扩展

成员

(只读) env :Env

Jasmine 环境。

类型
  • Env
请参阅

exitOnCompletion :boolean

在套件执行完毕时是否导致 Node 进程退出。

类型
  • boolean
覆盖
默认值
  • true

方法

addHelperFile(filePath)

向列表中添加助手文件,该列表将在套件执行时加载。

参数
名称 类型 描述
filePath string

要加载的文件的路径。

继承自

addMatchers(matchers)

为当前规格范围添加自定义匹配器。

注意:这只能从 beforeEachitbeforeAll 中调用。

参数
名称 类型 描述
matchers 对象

此对象中的键将是新匹配器名称。

请参阅

addMatchingHelperFiles(patterns)

向助手文件列表中添加与指定模式匹配的文件。

参数
名称 类型 描述
patterns Array.<string>

助手文件路径的数组或匹配助手文件的 glob 模式。每个路径或 glob 模式都将相对于 spec 目录进行评估。

继承自

addMatchingSpecFiles(patterns)

向 spec 文件列表中添加与指定模式匹配的文件。

参数
名称 类型 描述
patterns Array.<string>

spec 文件路径或匹配 spec 文件的 glob 模式的数组。每个路径或 glob 模式都将相对于 spec 目录进行评估。

继承自

addReporter(reporter)

向 Jasmine 环境添加一个自定义报告器。

参数
名称 类型 描述
reporter 报告器

要添加的报告器

覆盖
请参阅

addSpecFile(filePath)

在套件执行时将一个规范文件添加到列表中。

参数
名称 类型 描述
filePath string

要加载的文件的路径。

继承自

alwaysListPendingSpecs(value)

设置控制台报告器是否应在出现故障时列出挂起的规范。

参数
名称 类型 描述
value boolean
继承自

clearReporters()

清除所有已注册的报告器。

覆盖

configureDefaultReporter(options)

配置默认的报告器,如果未指定其他报告器,则安装默认的报告器。

参数
名称 类型 描述
options ConsoleReporterOptions
继承自

coreVersion() → {string}

返回值

已使用的 jasmine-core 版本

类型
string

(async) execute(filesopt, filterStringopt) → {Promise.<JasmineDoneInfo>}

运行测试套件。

注意:如果打算使用返回的承诺,请将 exitOnCompletion 设置为 false。否则,Node 进程通常会在解决承诺之前退出。

参数
名称 类型 属性 描述
files Array.<string> <可选>

要运行的规范文件,而不是先前配置的集合

filterString string <可选>

用于筛选规范的正则表达式。如果指定,则仅运行具有匹配全名称的规范。

返回值

套件完成后解决的承诺。

类型
Promise.<JasmineDoneInfo>

loadConfig(config)

从指定的对象加载配置。

参数
名称 类型 描述
config Configuration
继承自

loadConfigFile(configFilePathopt)

从指定的文件加载配置。该文件可以是 JSON 文件或任何可作为模块加载并提供 Jasmine 配置作为其默认导出的 JS 文件。

除非此 Jasmine 实例已使用 {jsLoader: 'require'} 配置,否则将通过动态 import() 加载配置文件。动态 import() 支持 ES 模块以及几乎所有 CommonJS 模块。

参数
名称 类型 属性 默认 描述
configFilePath string <可选>
spec/support/jasmine.json
继承自
返回值

承诺

provideFallbackReporter(reporter)

如果没有指定其他报告器,则提供后备报告器。

参数
名称 类型 描述
reporter

回退级联

请参阅

randomizeTests(value)

设置是否随机指定顺序。

参数
名称 类型 描述
value boolean

是否随机

seed(seed)

设置随机种子。

参数
名称 类型 描述
种子 数字

随机种子

showColors(value)

设置是否在控制台级联中显示颜色。

参数
名称 类型 描述
value boolean

是否显示颜色

继承自

stopOnSpecFailure(value)

设置是否在第一个规范失败后停止执行此套件。

参数
名称 类型 描述
value boolean

是否在第一个规范失败后停止执行此套件

stopSpecOnExpectationFailure(value)

设置是否导致规范仅具有一次预期失败。

参数
名称 类型 描述
value boolean

是否导致规范仅具有一次预期失败

verbose(value)

设置是否以详细模式运行,这将打印一些对于调试配置问题而言可能很有用的信息。

参数
名称 类型 描述
value boolean

是否以详细模式运行

继承自