外掛程式 API 簡介

雖然 Selenium IDE 可以向您傳送要求以執行任務（執行指令或發出指令），您也可以要求 IDE 執行任務。

Selenium IDE 實作類似 HTTP 的訊息傳遞協定。有關其運作方式的概觀，請參閱 呼叫 API。

API 結構

API 的結構依據權限範圍（例如播放、記錄等）而定。

版本控制

API 中的 uri 從 / 開始，並進行版本控制，目前最新版本為 1，呼叫沒有版本的 uri 表示最新版本。

• /register - 註冊函式的最新版本。
• /v1/register - 註冊 v1

動詞

API 支援類似 HTTP 的動詞（get、post、delete、put）。

每個動詞決定資源的不同功能。

• get - 取得資源或其資訊。
• post - 建立新的資源。
• put - 更新資源。
• delete - 刪除資源。

錯誤

如果在發送請求時關閉視窗，Selenium IDE 將不會回應，且 Promise 將會被拒絕。

或者，如果 Selenium IDE 已開啟，它可以成功執行，這將解決 Promise，或傳回「使用者端」錯誤，因為錯誤無法序列化。

連線錯誤

當 IDE 視窗關閉時，將會發生連線錯誤，因此 Promise 將會被拒絕。

browser.runtime.sendMessage(SIDE_ID, payload).catch((error) => {
  console.error(error); // connection error
});

請求錯誤

當請求無效時，將會發生請求錯誤，例如請求不存在的資源，例如 fetch。此類請求將以附加錯誤解決 Promise。

browser.runtime.sendMessage(SIDE_ID, payload).then((response) => {
  if (response.error) {
    console.error(response.error); // request error
  }
});

成功的要求

成功的要求是回應物件中未定義錯誤。每個端點都有其自己的回應，而大多數post要求如果成功，將回應true。

browser.runtime.sendMessage(SIDE_ID, payload).then((response) => {
  if (!response.error) {
    console.error(response); // true
  }
});