類別:Jasmine

Jasmine(options)

組態、建構及執行 Jasmine 測試套件

建構函式

new Jasmine(options)

參數
名稱 類型 描述
options JasmineOptions | undefined
範例
const Jasmine = require('jasmine');
const jasmine = new Jasmine();

成員

(readonly) env :Env

Jasmine 執行環境。

類型
  • Env
請參閱

方法

addMatchers(matchers)

針對目前的規格範圍新增自訂比對器。

注意: 這只能在 beforeEachitbeforeAll 內呼叫。

參數
名稱 類型 描述
matchers 物件

此物件中的金鑰將成為新的比對器名稱。

請參閱

addReporter(reporter)

新增自訂報告器至 Jasmine 執行環境。

參數
名稱 類型 描述
reporter 報告器

要新增的報告器

請參閱

addSpecFile(filePath)

將規格檔案新增至執行套件時將載入的清單。

參數
名稱 類型 描述
filePath 字串

要載入之檔案路徑。

clearReporters()

清除所有已註冊的報告器。

configureDefaultReporter(options)

若沒有指定其他報告器,將組態安裝的預設報告器。

參數
名稱 類型 描述
options ConsoleReporterOptions

coreVersion() → {string}

傳回值

所使用 jasmine-core 的版本

類型
字串

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

執行測試套件。

參數
名稱 類型 屬性 描述
files Array.<string> <optional>

要執行的規格檔案,用來取代先前組態的集合

filterString 字串 <optional>

用於篩選規格的 Regex。如果指定,只有符合完整名稱的規格才會執行。

傳回值

套件完成時,將會解析的 Promise。

類型
Promise.<void>

loadConfig(config)

從指定的物件載入組態。

參數
名稱 類型 描述
config 組態

loadConfigFile(configFilePathopt)

從指定的文件載入組態。該文件可以是 JSON 檔案,或任何可經由 require 載入,並提供 Jasmine 組態做為其預設輸出之 JS 檔。

參數
名稱 類型 屬性 預設 描述
configFilePath 字串 <optional>
spec/support/jasmine.json

onComplete(onCompleteCallback)

註冊一個在執行結束時被呼叫的回呼函數。

注意:只可註冊一個回呼函數。這個回呼函數會在測試套件完成,且結果確定完後呼叫,但並非一定要在 Jasmine 的所有清理工作都完成後才呼叫。

參數
名稱 類型 描述
onCompleteCallback 函數

provideFallbackReporter(reporter)

如果沒有指定其他報告工具,則提供一個後備報告工具。

參數
名稱 類型 描述
reporter

後備報告工具

請參閱

randomizeTests(value)

設定是否變更規格順序。

參數
名稱 類型 描述
value 布林值

是否變更順序

seed(seed)

設定隨機種子。

參數
名稱 類型 描述
seed 數字

隨機種子

showColors(value)

設定是否在主控台報告工具中顯示顏色。

參數
名稱 類型 描述
value 布林值

是否顯示顏色

stopOnSpecFailure(value)

設定是否在第一個規格失敗後停止執行套件。

參數
名稱 類型 描述
value 布林值

是否在第一個規格失敗後停止執行套件

stopSpecOnExpectationFailure(value)

設定是否導致規格只有一個期望值的失敗。

參數
名稱 類型 描述
value 布林值

是否導致規格只有一個期望值的失敗