runtime.setUninstallURL()

設定在擴充套件程式解除安裝時將訪問的 URL。這可用於清理伺服器端資料、進行分析或實現調查。URL 最長可達 1023 個字元。此限制過去為 255 個字元,有關更多詳細資訊,請參閱 瀏覽器相容性

這是一個非同步函式,返回一個 Promise

語法

js
let settingUrl = browser.runtime.setUninstallURL(
  url             // string
)

引數

url

string。擴充套件程式解除安裝後將開啟的 URL。此 URL 必須具有 httphttps 協議。最多可包含 1023 個字元。將其設定為空字串,以便在擴充套件程式解除安裝時不再開啟新標籤頁。

返回值

一個 Promise,在設定 URL 時會以無引數形式解析,如果操作失敗,則會以錯誤訊息拒絕。

示例

js
function onSetURL() {
  console.log("set uninstall URL");
}

function onError(error) {
  console.log(`Error: ${error}`);
}

let settingUrl = browser.runtime.setUninstallURL("https://example.org");
settingUrl.then(onSetURL, onError);

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.runtime API。本文件源自 Chromium 程式碼中的 runtime.json