類別:Jasmine

Jasmine(options)

設定、建立和執行 Jasmine 測試套組

建構函式

new Jasmine(options)

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

成員

(readonly) env :Env

Jasmine 環境。

類型
  • Env
請參閱

exitOnCompletion :boolean

當套件執行完成時,是否導致 Node 程序結束。

類型
  • 布林值
預設值
  • true

方法

addHelperFile(filePath)

將 helper 檔案加入到套件執行時載入的清單中

參數
名稱 類型 說明
filePath string

要載入的檔案的路徑。

addMatchers(matchers)

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

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

參數
名稱 類型 說明
matchers 物件

此物件的 Keys 將會是新的比對器名稱。

請參閱

addMatchingHelperFiles(patterns)

將符合指定的模式的檔案加入 helper 檔案清單中

參數
名稱 類型 說明
patterns Array.<string>

helper 檔案路徑或符合 helper 檔案的 glob 陣列。每一個路徑或 glob 都會相對應到規格目錄來評估。

addMatchingSpecFiles(patterns)

將符合指定的模式的檔案加入規格檔案清單中

參數
名稱 類型 說明
patterns Array.<string>

符合規格檔案的規格檔案路徑或 glob 陣列。每一個路徑或 glob 都會相對應到規格目錄來評估。

addReporter(reporter)

將自訂的記者加入到 Jasmine 環境中

參數
名稱 類型 說明
reporter 記者

要加入的記者

請參閱

addSpecFile(filePath)

將規格檔案加入到套件執行時載入的清單中

參數
名稱 類型 說明
filePath string

要載入的檔案的路徑。

clearReporters()

清除所有已註冊的記者

configureDefaultReporter(options)

設定預設的記者,如果沒有指定其他記者,則會安裝這個預設記者。

參數
名稱 類型 說明
options ConsoleReporterOptions

coreVersion() → {string}

回傳值

正在使用的 jasmine-core 的版本

類型
string

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

執行測試套組。

註解:如果你打算使用傳回的承諾,請設定 exitOnCompletion 為 false。否則,Node 程序通常會在承諾解決之前退出。

參數
名稱 類型 屬性 說明
files Array.<string> <可選>

要執行的規格檔案,取代先前設定的組

filterString string <可選>

用於篩選規格的正規表達式。如已指定,將只執行符合完整名稱的規格。

回傳值

套件完成後,會解析的承諾。

類型
Promise.<JasmineDoneInfo>

loadConfig(config)

從指定的物件載入設定。

參數
名稱 類型 說明
config 設定

loadConfigFile(configFilePathopt)

從指定的檔案載入設定。檔案可以是 JSON 檔案或任何可透過 require 載入並提供 Jasmine 設定作為其預設匯出的 JS 檔案。

參數
名稱 類型 屬性 預設值 說明
configFilePath string <可選>
spec/support/jasmine.json
回傳值

承諾

provideFallbackReporter(reporter)

如果未指定其他報告員,則提供備援報告員。

參數
名稱 類型 說明
reporter

備援報告員

請參閱

randomizeTests(value)

設定是否隨機排序規格順序。

參數
名稱 類型 說明
value 布林值

是否隨機化

seed(seed)

設定亂數種子。

參數
名稱 類型 說明
seed 數字

亂數種子

showColors(value)

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

參數
名稱 類型 說明
value 布林值

是否顯示顏色

stopOnSpecFailure(value)

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

參數
名稱 類型 說明
value 布林值

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

stopSpecOnExpectationFailure(value)

設定規格是否只能有一個失敗預期。

參數
名稱 類型 說明
value 布林值

規格是否只能有一個失敗預期