Spec 報告器

一個以 spec 風格報告的 WebdriverIO 外掛程式。

安裝

最簡單的方法是透過以下方式，將 @wdio/spec-reporter 作為您 package.json 中的開發依賴項：

npm install @wdio/spec-reporter --save-dev

關於如何安裝 WebdriverIO 的說明可以在這裡找到。

設定

以下程式碼顯示預設的 wdio 測試執行器設定。只需將 'spec' 作為報告器添加到陣列中。

// wdio.conf.js
module.exports = {
  // ...
  reporters: ['dot', 'spec'],
  // ...
};

Spec 報告器選項

符號

為 passed、failed 和/或 skipped 測試提供自訂符號

類型：object 預設值：{passed: '✓', skipped: '-', failed: '✖'}

範例

[
  "spec",
  {
    symbols: {
      passed: '[PASS]',
      failed: '[FAIL]',
    },
  },
]

sauceLabsSharableLinks

預設情況下，Sauce Labs 中的測試結果只能由同一團隊的成員查看，而不能由不同團隊的成員查看。此選項將預設啟用可分享連結，這意味著在 Sauce Labs 中執行的所有測試都可以被所有人查看。只需在報告器選項中加入 sauceLabsSharableLinks: false，如下所示，即可停用此功能。

類型：boolean 預設值：true

範例

[
  "spec",
  {
    sauceLabsSharableLinks: false,
  },
]

onlyFailures

僅列印失敗的 spec 結果。

類型：boolean 預設值：false

範例

[
  "spec",
  {
    onlyFailures: true,
  },
]

addConsoleLogs

設定為 true 以在最終報告中顯示步驟的控制台記錄

類型：boolean 預設值：false

[
  "spec",
  {
    addConsoleLogs: true,
  },
]

realtimeReporting

設定為 true 以即時顯示測試狀態，而不僅僅在執行結束時顯示

類型：boolean 預設值：false

[
  "spec",
  {
    realtimeReporting: true,
  },
]

showPreface

設定為 false 以停用報告中的 [ MutliRemoteBrowser ... ] 前言。

類型：boolean 預設值：true

[
  "spec",
  {
    showPreface: false,
  },
]

設定為 false 時，您將看到如下輸出

Running: loremipsum (v50) on Windows 10
Session ID: foobar

» /foo/bar/loo.e2e.js
Foo test
   green ✓ foo
   green ✓ bar

» /bar/foo/loo.e2e.js
Bar test
   green ✓ some test
   red ✖ a failed test
   red ✖ a failed test with no stack

而設定為 true（預設）時，每一行都將以序言作為前綴

[loremipsum 50 Windows 10 #0-0] Running: loremipsum (v50) on Windows 10
[loremipsum 50 Windows 10 #0-0] Session ID: foobar
[loremipsum 50 Windows 10 #0-0]
[loremipsum 50 Windows 10 #0-0] » /foo/bar/loo.e2e.js
[loremipsum 50 Windows 10 #0-0] Foo test
[loremipsum 50 Windows 10 #0-0]    green ✓ foo
[loremipsum 50 Windows 10 #0-0]    green ✓ bar
[loremipsum 50 Windows 10 #0-0]
[loremipsum 50 Windows 10 #0-0] » /bar/foo/loo.e2e.js
[loremipsum 50 Windows 10 #0-0] Bar test
[loremipsum 50 Windows 10 #0-0]    green ✓ some test
[loremipsum 50 Windows 10 #0-0]    red ✖ a failed test
[loremipsum 50 Windows 10 #0-0]    red ✖ a failed test with no stack
[loremipsum 50 Windows 10 #0-0]

color

設定為 true 以在終端機中顯示彩色輸出

類型：boolean 預設值：true

[
  "spec",
  {
    color: true,
  },
]

環境選項

您可以透過環境變數設定某些選項

FORCE_COLOR

如果設定為 true，例如透過 FORCE_COLOR=0 npx wdio run wdio.conf.js，則會停用所有終端機顏色。