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