Documentation Home
這個頁面描述 Jasmine 的預發行版本 (5.0.0-alpha.1)。在最後推出 5.0 之前,可能會有一些變更,包括重大變更。

類別:Jasmine

Jasmine(選項)

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

建構函式

new Jasmine(選項)

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

延伸

成員

(唯讀) env :Env

Jasmine 環境。

類型
  • Env
另請參閱

exitOnCompletion :boolean

在套件完成執行時,是否導致 Node 程序退出。

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

方法

addHelperFile(檔案路徑)

在套件執行的清單中新增一個輔助檔案。

參數
名稱 類型 描述
檔案路徑 字串

要載入的檔案路徑。

繼承自

addMatchers(比對器)

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

注意: 這只可以在 beforeEachitbeforeAll 中呼叫。

參數
名稱 類型 描述
比對器 物件

這個物件中的金鑰會是新的比對器名稱。

另請參閱

addMatchingHelperFiles(樣式)

將符合指定樣式的檔案新增到輔助檔案清單中。

參數
名稱 類型 描述
樣式 Array.<string>

一個包含輔助檔案路徑或符合輔助檔案的 Glob 陣列。每個路徑或 Glob 都會相對規格目錄來評估。

繼承自

addMatchingSpecFiles(樣式)

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

參數
名稱 類型 描述
樣式 Array.<string>

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

繼承自

addReporter(記者)

在 Jasmine 環境中新增一個自訂記者。

參數
名稱 類型 描述
記者 記者

要新增的記者

覆寫
另請參閱

addSpecFile(檔案路徑)

在套件執行的清單中新增一個規格檔案。

參數
名稱 類型 描述
檔案路徑 字串

要載入的檔案路徑。

繼承自

alwaysListPendingSpecs(值)

設定主控台記者在有失敗時,是否列出待處理的規格。

參數
名稱 類型 描述
布林值
繼承自

clearReporters()

清除所有已註冊的記者。

覆寫

configureDefaultReporter(選項)

設定在沒有指定其他記者時,已安裝的預設記者。

參數
名稱 類型 描述
選項 ConsoleReporterOptions
繼承自

coreVersion() → {string}

回傳值

目前使用的 jasmine-core 版本

類型
字串

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

執行測試套件。

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

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

要執行而不是先前設定的集合的規格檔案

filterString 字串 <optional>

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

回傳值

套件完成後將解決的承諾。

類型
Promise.<JasmineDoneInfo>

loadConfig(config)

從指定物件載入組態。

參數
名稱 類型 描述
config Configuration
繼承自

loadConfigFile(configFilePathopt)

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

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

Promise

provideFallbackReporter(reporter)

如果沒有指定其他報告員,請提供備用報告員。

參數
名稱 類型 描述
記者

備用報告員

另請參閱

randomizeTests(value)

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

參數
名稱 類型 描述
布林值

是否要隨機化

seed(seed)

設定隨機種子。

參數
名稱 類型 描述
種子 數字

隨機種子

showColors(value)

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

參數
名稱 類型 描述
布林值

是否要顯示顏色

繼承自

stopOnSpecFailure(value)

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

參數
名稱 類型 描述
布林值

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

stopSpecOnExpectationFailure(value)

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

參數
名稱 類型 描述
布林值

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