Documentation Home
此頁面說明 Jasmine 的預發行版本 (5.0.0-beta.0)。在 5.0 最終版本釋出前,可能會進行其他變更,包括破壞性變更。

類別:Jasmine

Jasmine(options)

設定、建置並執行 Jasmine 測試套件。
請另見 ParallelRunner,它提供等效功能以進行平行執行。

建構函式

new Jasmine(options)

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

延伸

成員

(唯讀) env :Env

Jasmine 環境。

類型
  • Env
請參閱

exitOnCompletion :boolean

套件執行完畢時,是否會使 Node 程序結束。

類型
  • boolean
覆寫
預設值
  • true

方式

addHelperFile(filePath)

將一個 helper 檔案新增到套件執行時載入的清單中。

參數
名稱 類型 說明
filePath 字串

要載入的檔案路徑。

繼承自

addMatchers(matchers)

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

註: 這只能在 beforeEachitbeforeAll 中呼叫。

參數
名稱 類型 說明
matchers 物件

此物件的鍵會成為新的比對器名稱。

請參閱

addMatchingHelperFiles(patterns)

將符合指定模式的檔案新增到 helper 檔案清單中。

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

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

繼承自

addMatchingSpecFiles(patterns)

將符合指定模式的檔案新增到規格檔案清單中。

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

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

繼承自

addReporter(reporter)

將自訂報告新增到 Jasmine 環境中。

參數
名稱 類型 說明
reporter 報告

要新增的報告

覆寫
請參閱

addSpecFile(filePath)

將一個規格檔案新增到套件執行時載入的清單中。

參數
名稱 類型 說明
filePath 字串

要載入的檔案路徑。

繼承自

alwaysListPendingSpecs(value)

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

參數
名稱 類型 說明
value boolean
繼承自

clearReporters()

清除所有已註冊的報告。

覆寫

configureDefaultReporter(options)

設定在未指定其他報告員時安裝的預設報告員。

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

coreVersion() → {string}

傳回

jasmine-core 中使用的版本

類型
字串

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

執行測試組。

注意:如果你打算使用回傳的 promise,請將 exitOnCompletion 設定為 false。否則,Node 程式一般會在 promise 接收之前就結束。

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

執行規格檔案,而不是先前設定的組

filterString 字串 <optional>

用於過濾規格的正規表示式。如果指定,將只有完整名稱與其相符的規格執行。

傳回

在組完成時回傳的 promise。

類型
Promise.<JasmineDoneInfo>

loadConfig(config)

從指定的物件載入設定。

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

loadConfigFile(configFilePathopt)

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

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

Promise

provideFallbackReporter(reporter)

如果未指定其他報告員,提供替代報告員。

參數
名稱 類型 說明
reporter

替代報告員

請參閱

randomizeTests(value)

設定規格順序是否會隨機化。

參數
名稱 類型 說明
value boolean

是否要隨機化

seed(seed)

設定隨機種子。

參數
名稱 類型 說明
seed number

隨機種子

showColors(value)

設定是否在控制台報告員中顯示色彩。

參數
名稱 類型 說明
value boolean

是否顯示色彩

繼承自

stopOnSpecFailure(value)

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

參數
名稱 類型 說明
value boolean

在第一次規格失敗後是否停止執行組。

stopSpecOnExpectationFailure(value)

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

參數
名稱 類型 說明
value boolean

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