開始使用
歡迎來到 WebdriverIO 文件。它將幫助您快速上手。如果您遇到問題，可以在我們的Discord 支援伺服器上找到幫助和答案，或者您可以在Twitter上聯繫我。
這些是最新版本（>=8.x）WebdriverIO 的文件。如果您仍然使用舊版本，請訪問舊的文件網站！
您可以在官方 YouTube 頻道上找到更多關於 WebdriverIO 的影片。請務必訂閱！
啟動 WebdriverIO 設定
若要使用WebdriverIO 入門工具組將完整的 WebdriverIO 設定新增至現有或新專案，請執行
如果您在現有專案的根目錄中，請執行
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest .
或者如果您想建立一個新專案
npm init wdio@latest ./path/to/new/project
yarn create wdio .
或者如果您想建立一個新專案
yarn create wdio ./path/to/new/project
pnpm create wdio@latest .
或者如果您想建立一個新專案
pnpm create wdio@latest ./path/to/new/project
bun create wdio@latest .
或者如果您想建立一個新專案
bun create wdio@latest ./path/to/new/project
此單一命令會下載 WebdriverIO CLI 工具，並執行設定精靈，協助您設定測試套件。
精靈會提示一組問題，引導您完成設定。您可以傳遞 --yes 參數來選擇預設設定，此設定會使用 Mocha 和 Chrome 以及頁面物件模式。
- NPM
- Yarn
- pnpm
- bun
npm init wdio@latest . -- --yes
yarn create wdio . --yes
pnpm create wdio@latest . --yes
bun create wdio@latest . --yes
手動安裝 CLI
您也可以透過以下方式，將 CLI 套件手動新增至您的專案
npm i --save-dev @wdio/cli
npx wdio --version # prints e.g. `8.13.10`
# run configuration wizard
npx wdio config
執行測試
您可以使用 run 命令並指向您剛建立的 WebdriverIO 設定檔，來啟動您的測試套件
npx wdio run ./wdio.conf.js
如果您想執行特定的測試檔案，您可以新增 --spec 參數
npx wdio run ./wdio.conf.js --spec example.e2e.js
或在您的設定檔中定義套件，然後只執行套件中定義的測試檔案
npx wdio run ./wdio.conf.js --suite exampleSuiteName
在指令碼中執行
如果您想在 Node.JS 指令碼的獨立模式中使用 WebdriverIO 作為自動化引擎，您也可以直接安裝 WebdriverIO 並將其作為套件使用，例如產生網站的螢幕截圖
loading...
注意：所有 WebdriverIO 命令都是非同步的，需要使用async/await妥善處理。
錄製測試
WebdriverIO 提供工具來協助您開始，方法是在螢幕上錄製您的測試動作，並自動產生 WebdriverIO 測試指令碼。如需詳細資訊，請參閱使用 Chrome DevTools 錄製器錄製測試。
系統需求
您需要安裝 Node.js。
- 至少安裝 v18.20.0 或更高版本，因為這是最舊的活躍 LTS 版本
- 只有屬於或將成為 LTS 版本的版本才受到官方支援
如果您的系統上目前未安裝 Node，我們建議您使用諸如NVM或Volta之類的工具，以協助管理多個活躍的 Node.js 版本。NVM 是一種常見的選擇，而 Volta 也是一個不錯的替代方案。
