类:Jasmine

Jasmine(options)

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

构造函数

new Jasmine(options)

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

扩展

成员

(readonly) env :Env

Jasmine 环境。

类型
  • Env
请参阅

exitOnCompletion :boolean

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

类型
  • boolean
替代
默认值
  • true

方法

addHelperFile(filePath)

在套件执行时将辅助文件添加到列表中。

参数
名称 类型 说明
filePath string

要加载的文件的路径。

继承自

addMatchers(matchers)

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

注意:这仅可在 beforeEachitbeforeAll 中调用。

参数
名称 类型 说明
matchers Object

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

请参阅

addMatchingHelperFiles(patterns)

将与指定模式匹配的文件添加到辅助文件列表中。

参数
名称 类型 说明
patterns Array.<string>

辅助文件路径或与辅助文件匹配的 glob 的数组。每个路径或 glob 会根据规范目录进行评估。

继承自

addMatchingSpecFiles(patterns)

将与指定模式匹配的文件添加到规范文件列表中。

参数
名称 类型 说明
patterns Array.<string>

规范文件路径或与规范文件匹配的 glob 的数组。每个路径或 glob 会根据规范目录进行评估。

继承自

addReporter(reporter)

将自定义报告器添加到 Jasmine 环境中。

参数
名称 类型 说明
reporter 报告器

要添加的汇报器

替代
请参阅

addSpecFile(filePath)

向列表中添加一个 spec 文件,当执行 suite 时会加载该文件。

参数
名称 类型 说明
filePath string

要加载的文件的路径。

继承自

alwaysListPendingSpecs(value)

设置控制台汇报器是否应在有失败时列出挂起的 spec。

参数
名称 类型 说明
boolean
继承自

clearReporters()

清除所有注册的汇报器。

替代

configureDefaultReporter(options)

配置在未指定其他汇报器时安装的默认汇报器。

参数
名称 类型 说明
options ConsoleReporterOptions
继承自

coreVersion() → {string}

返回

正在使用的 jasmine-core 版本

类型
string

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

运行测试套件。

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

参数
名称 类型 属性 说明
文件 Array.<string> <可选>

要运行的 spec 文件,而不是之前配置的集合

filterString string <可选>

用于过滤 spec 的正则表达式。如果指定,则仅运行具有匹配完整名称的 spec。

返回

套件完成后解决的 Promise。

类型
Promise.<JasmineDoneInfo>

loadConfig(config)

从指定的对象加载配置。

参数
名称 类型 说明
配置 Configuration
继承自

loadConfigFile(configFilePathopt)

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

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

Promise

provideFallbackReporter(reporter)

如果未指定其他汇报器,则提供一个后备汇报器。

参数
名称 类型 说明
reporter

后备汇报器

请参阅

randomizeTests(value)

设置是否随机排列 spec 的顺序。

参数
名称 类型 说明
boolean

是否随机排列

seed(seed)

设置随机种子。

参数
名称 类型 说明
种子 数字

随机种子

showColors(value)

设置是否在控制台汇报器中显示颜色。

参数
名称 类型 说明
boolean

是否显示颜色

继承自

stopOnSpecFailure(value)

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

参数
名称 类型 说明
boolean

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

stopSpecOnExpectationFailure(value)

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

参数
名称 类型 说明
boolean

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