Selenium 獨立版

file

上傳檔案至瀏覽器正在執行的遠端機器。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.file(file)

參數

名稱	類型	詳細資訊
file	字串	包含要上傳的單一檔案的 Base64 編碼 zip 壓縮檔。如果 Base64 編碼的資料不代表 zip 壓縮檔，或者壓縮檔包含多個檔案，則會擲回未知錯誤。

回傳值

• <字串> path: 遠端機器上已上傳檔案的絕對路徑。

---

getDownloadableFiles

列出遠端機器上可供下載的檔案。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.getDownloadableFiles()

回傳值

• <物件> names: 包含遠端機器上可下載檔案清單的物件。

---

download

從瀏覽器正在執行的遠端機器下載檔案。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.download(name)

參數

名稱	類型	詳細資訊
name	字串	要下載的檔案名稱

回傳值

• <物件> data: 包含已下載檔案名稱及其內容的物件

---

deleteDownloadableFiles

從瀏覽器正在執行的遠端機器移除所有可下載的檔案。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.deleteDownloadableFiles()

---

getHubConfig

遠端接收 Hub 設定。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.getHubConfig()

回傳值

• <物件> config: 回傳 Hub 設定，其中包含 slotCount、timeout 和其他資訊。

---

gridTestSession

取得執行工作階段的 Selenium Grid 節點詳細資訊。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.gridTestSession(session)

參數

名稱	類型	詳細資訊
session	字串	要接收 Hub 詳細資訊的工作階段 ID。

回傳值

• <物件> details: 包含工作階段詳細資訊的物件。

---

gridProxyDetails

取得 Proxy 詳細資訊。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.gridProxyDetails(id)

參數

名稱	類型	詳細資訊
id	字串	Proxy 的 ID (可以使用 gridTestSession 指令接收)。

回傳值

• <物件> details: 包含 Proxy 資訊的物件。

---

manageSeleniumHubLifecycle

管理 Hub 節點的生命週期。

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.manageSeleniumHubLifecycle(action)

參數

名稱	類型	詳細資訊
action	字串	要在 Selenium Hub 上呼叫的指令。唯一實作的動作是「關閉」Hub。

---

queryGrid

傳送 GraphQL 查詢至 Selenium (Hub 或節點) 伺服器以擷取資料。(僅支援 Selenium v4 伺服器)

Selenium 獨立版指令。更多詳細資訊可以在官方協定文件中找到。

用法

browser.queryGrid(query)

參數

名稱	類型	詳細資訊
query	字串	要傳送到伺服器的 GraphQL 查詢。

範例

const result = await browser.queryGrid('{ nodesInfo { nodes { status, uri } } }');
console.log(JSON.stringify(result, null, 4))
/**
 * outputs:
 * {
 *   "data": {
 *     "nodesInfo": {
 *       "nodes": [{
 *         "status": "UP",
 *         "uri": "http://192.168.0.39:4444"
 *       }]
 *     }
 *   }
 * }
 */

回傳值

• <物件> data: GraphQL 查詢的結果。