總覽

Nightwatch v2.0 引入了一個新的介面來定義外掛程式,並使用您自己的自訂指令和斷言來擴展 Nightwatch 的基本功能。

外掛程式本質上是自訂指令和斷言的包裝器。外掛程式安裝在您的 node_modules 資料夾中。

撰寫 Nightwatch 外掛程式

如果您不熟悉發佈 NPM 套件,請先閱讀建立和發佈非範圍限定的公開套件指南。

需要從 NPM 將 Nightwatch 外掛程式安裝在與使用 Nightwatch 的專案相同的專案中 (或作為全域 NPM 套件)。

資料夾結構

資料夾結構非常簡單,如下所示。nightwatch 資料夾必須存在於外掛程式中,其中自訂指令和斷言將自動從中載入。

  ├── nightwatch/ 
  |   ├── commands/
  |   |    ├── my_new_custom_command.js
  |   |    └── my_other_custom_command.js
  |   └── assertions/
  |        ├── my_new_custom_assertions.js
  |        └── my_other_custom_command.js
  ├── index.js
  ├── LICENSE.md
  ├── package.json
  └── README.md

如果外掛程式使用上述結構定義,Nightwatch 執行器將會自動拾取自訂指令和斷言。

安裝新的外掛程式

一旦外掛程式在 NPM (或其他套件儲存庫) 中可用,您可以簡單地將其安裝在您的專案資料夾中,然後透過將其新增至 plugins 陣列來更新 Nightwatch 組態檔。

首先,從 NPM 安裝外掛程式

npm i my-new-plugin --save-dev

然後更新您的 nightwatch.conf.js (或 nightwatch.json) 並將其新增至 plugins 清單

nightwatch.conf.js
{
  plugins: ['my-new-plugin']
  
// other nightwatch config options
}