類別：Jasmine

Jasmine(options)

設定、建構和執行 Jasmine 測試套件。
另請參閱 ParallelRunner，它提供平行執行的等效功能。

建構函式

new Jasmine(options)

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

延伸

成員

(readonly) env :Env

Jasmine 環境。

類型
  • Env
參閱

exitOnCompletion :boolean

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

類型
  • boolean
覆寫
預設值
  • true

方法

addHelperFile(filePath)

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

參數
名稱 類型 說明
filePath 字串

要載入檔案的路徑。
由下列繼承

addMatchers(matchers)

為目前的規格範圍加入自訂對應器。

注意：這只有在 beforeEach、it 或 beforeAll 中才能呼叫。

參數
名稱 類型 說明
對應器 物件

此物件的鍵將是新的對應器名稱。
參閱

addMatchingHelperFiles(patterns)

在輔助檔案清單中加入符合指定模式的檔案。

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

輔助檔案路徑或符合輔助檔案的 glob 陣列。每個路徑或 glob 都會根據規格目錄評估。
由下列繼承

addMatchingSpecFiles(patterns)

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

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

規格檔案路徑或符合規格檔案的 glob 陣列。每個路徑或 glob 都會根據規格目錄評估。
由下列繼承

addReporter(reporter)

在 Jasmine 環境中加入一個自訂回報器。

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

要加入的回報器
覆寫
參閱

addSpecFile(filePath)

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

參數
名稱 類型 說明
filePath 字串

要載入檔案的路徑。
由下列繼承

alwaysListPendingSpecs(value)

設定主控台報告器是否在有失敗時列出待處理的規格。

參數
名稱 類型 說明
value boolean
由下列繼承

clearReporters()

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

覆寫

configureDefaultReporter(options)

設定如果未指定其他報告器時安裝的預設報告器。

參數
名稱 類型 說明
選項 ConsoleReporterOptions
由下列繼承

coreVersion() → {string}

傳回值

使用的 jasmine-core 版本

類型
字串

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

執行測試套件。

備註: 如果預計使用傳回的承諾，請將 exitOnCompletion 設定為 false。否則，節點程序通常會在解決承諾之前退出。

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

要執行的規格檔案，取代之前設定的集合
filterString 字串 <選用>

用於篩選規格的正規表示法。如果指定，只有符合完整名稱的規格才會執行。
傳回值

套件完成時解析的承諾。

類型
Promise.<JasmineDoneInfo>

loadConfig(config)

從指定的物件載入設定。

參數
名稱 類型 說明
config Configuration
由下列繼承

loadConfigFile(configFilePathopt)

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

參數
名稱 類型 屬性 預設值 說明
configFilePath 字串 <選用>
 spec/support/jasmine.json
由下列繼承
傳回值

承諾

provideFallbackReporter(reporter)

如果未指定其他報告器，請提供備用報告器。

參數
名稱 類型 說明
回報器

備用報告器
參閱

randomizeTests(value)

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

參數
名稱 類型 說明
value boolean

是否要隨機排列

seed(seed)

設定隨機種子。

參數
名稱 類型 說明
seed number

隨機種子

showColors(value)

設定是否在主控台報告器中顯示色彩。

參數
名稱 類型 說明
value boolean

是否顯示色彩
由下列繼承

stopOnSpecFailure(value)

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

參數
名稱 類型 說明
value boolean

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

stopSpecOnExpectationFailure(value)

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

參數
名稱 類型 說明
value boolean

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