類別：Jasmine

Jasmine(選項)

組態、建立和執行 Jasmine 測試套件。
另見 ParallelRunner，它提供等效平行執行的功能。

建構函式

new Jasmine(選項)

參數
名稱 類型 說明
選項 JasmineOptions | 未定義
範例
const Jasmine = require('jasmine');
const jasmine = new Jasmine();

擴充

成員

(唯讀) env :Env

Jasmine 環境。

類型
  • Env
參閱

exitOnCompletion :boolean

當套件執行完畢時，是否導致節點處理序離開。

類型
  • 布林值
覆寫
預設值
  • true

方法

addHelperFile(檔案路徑)

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

參數
名稱 類型 說明
檔案路徑 字串

要載入的檔案路徑。
繼承自

addMatchers(比較器)

為目前範圍的規格加入自訂比較器。

注意：這只能從 beforeEach、it 或 beforeAll 中呼叫。

參數
名稱 類型 說明
比較器 物件

此物件的鍵值會成為新的比較器名稱。
參閱

addMatchingHelperFiles(樣式)

將與指定樣式相符的檔案加入到輔助檔案清單中。

參數
名稱 類型 說明
樣式 陣列<字串>

與輔助檔案相符的輔助檔案路徑或 Glob 的陣列。每個路徑或 Glob 都會相對於規格目錄評估。
繼承自

addMatchingSpecFiles(樣式)

將與指定樣式相符的檔案加入到規格檔案清單中。

參數
名稱 類型 說明
樣式 陣列<字串>

與規格檔案相符的規格檔案路徑或 Glob 的陣列。每個路徑或 Glob 都會相對於規格目錄評估。
繼承自

addReporter(回報器)

將自訂回報器加入到 Jasmine 環境中。

參數
名稱 類型 說明
回報器 回報器

要加入的回報器
覆寫
參閱

addSpecFile(檔案路徑)

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

參數
名稱 類型 說明
檔案路徑 字串

要載入的檔案路徑。
繼承自

alwaysListPendingSpecs(值)

設定主控台回報器是否應列出待處理規格，即使有失敗。

參數
名稱 類型 說明
值 布林值
繼承自

clearReporters()

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

覆寫

configureDefaultReporter(選項)

在未指定其他報導工具時，設定已安裝的預設報導工具。

參數
名稱 類型 說明
選項 ConsoleReporterOptions
繼承自

coreVersion() → {string}

傳回

正在使用的 jasmine-core 版本

類型
字串

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

執行測試套件。

注意：如果您打算使用傳回的 Promise，請將 exitOnCompletion 設為 false。否則，常規情況下，Node 程序會在 Promise 完成之前結束。

參數
名稱 類型 屬性 說明
files 陣列<字串> <optional>

Spec 檔案，取代之前設定的組
filterString 字串 <optional>

用於過濾規格的正規表示式。如果指定，只會執行與完整名稱相符的規格。
傳回

套件完成時會完成的 Promise。

類型
Promise.<JasmineDoneInfo>

loadConfig(config)

從指定的物件載入設定。

參數
名稱 類型 說明
config 組態
繼承自

loadConfigFile(configFilePathopt)

從指定的檔案載入設定。檔案可以是 JSON 檔案或任何可作為模組載入且提供 Jasmine 設定為預設匯出的 JS 檔案。

除了已配置為 {jsLoader: 'require'} 的 Jasmine 實例，設定檔將透過動態 import() 載入。動態 import() 支援 ES 模組以及幾乎所有 CommonJS 模組。

參數
名稱 類型 屬性 預設 說明
configFilePath 字串 <optional>
 spec/support/jasmine.json
繼承自
傳回

Promise

provideFallbackReporter(reporter)

如果沒有指定其他報導工具，請提供備用報導工具。

參數
名稱 類型 說明
回報器

備用報導工具
參閱

randomizeTests(value)

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

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

是否隨機排列

seed(seed)

設定隨機種子。

參數
名稱 類型 說明
seed number

隨機種子

showColors(value)

設定是否在終端機報導工具中顯示色彩。

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

是否顯示色彩
繼承自

stopOnSpecFailure(value)

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

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

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

stopSpecOnExpectationFailure(value)

設定是否只讓規格執行一次預期失敗。

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

是否只讓規格執行一次預期失敗

verbose(value)

設定是否以詳述模式執行，輸出資料對於排解設定錯誤可能相當有用。

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

是否以詳述模式執行
繼承自