类:Jasmine

Jasmine(options)

配置、构建和执行一个 Jasmine 测试套件

构造函数

new Jasmine(options)

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

成员

alwaysListPendingSpecs

设置当有失败时控制台报告程序员是否列出未处理的规范。

(readonly) env :Env

Jasmine 环境。

类型
  • Env
请参见

exitOnCompletion :boolean

套件执行完毕后是否导致 Node 流程退出。

类型
  • 布尔值
默认值
  • true

方法

addHelperFile(filePath)

向套件执行时将加载的文件列表中添加一个帮助程序文件。

参数
名称 类型 描述
filePath 字符串

要加载的文件的路径。

addMatchers(matchers)

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

注意:只能在 beforeEachitbeforeAll 中调用此函数。

参数
名称 类型 描述
matchers 对象

该对象中的键将是新的匹配程序名称。

请参见

addMatchingHelperFiles(patterns)

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

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

与助手文件匹配的助手文件路径或 glob 的数组。 每个路径或 glob 将相对于规范目录进行评估。

addMatchingSpecFiles(patterns)

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

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

与规范文件匹配的规范文件路径或 glob 的数组。 每个路径或 glob 将相对于规范目录进行评估。

addReporter(reporter)

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

参数
名称 类型 描述
reporter 报告程序

要添加的报告程序

请参见

addSpecFile(filePath)

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

参数
名称 类型 描述
filePath 字符串

要加载的文件的路径。

clearReporters()

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

configureDefaultReporter(options)

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

参数
名称 类型 描述
options ConsoleReporterOptions

coreVersion() → {string}

返回

正在使用的 jasmine-core 的版本

类型
字符串

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

运行测试套件。

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

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

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

filterString 字符串 <可选>

用于筛选规范的 Regex。如果已指定,则只有名称完全匹配的规范将被运行。

返回

套件完成后解决的 Promise。

类型
Promise.<JasmineDoneInfo>

loadConfig(config)

从指定对象加载配置。

参数
名称 类型 描述
config Configuration

(async) loadConfigFile(configFilePathopt)

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

参数
名称 类型 属性 默认 描述
configFilePath 字符串 <可选>
spec/support/jasmine.json
返回

Promise

provideFallbackReporter(reporter)

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

参数
名称 类型 描述
reporter

后备报告器

请参见

randomizeTests(value)

设置是否要随机排列规范的顺序。

参数
名称 类型 描述
value 布尔值

是否要随机排列

seed(seed)

设置随机种子。

参数
名称 类型 描述
seed number

随机种子

showColors(value)

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

参数
名称 类型 描述
value 布尔值

是否显示颜色

stopOnSpecFailure(value)

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

参数
名称 类型 描述
value 布尔值

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

stopSpecOnExpectationFailure(value)

设置是否使规范仅有一个期望值失败。

参数
名称 类型 描述
value 布尔值

是否导致规范只出现一个预期失败