runtime.setUninstallURL()

Legt die URL fest, die aufgerufen wird, wenn die Erweiterung deinstalliert wird. Dies kann verwendet werden, um serverseitige Daten zu bereinigen, Analysen durchzuführen oder Umfragen zu implementieren. Die URL kann bis zu 1023 Zeichen lang sein. Dieses Limit betrug früher 255, siehe Browser-Kompatibilität für weitere Details.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

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

Parameter

url

string. URL, die geöffnet wird, nachdem die Erweiterung deinstalliert wurde. Diese URL muss ein http- oder https-Schema haben. Kann bis zu 1023 Zeichen lang sein. Auf einen leeren String setzen, um beim Deinstallieren der Erweiterung keinen neuen Tab zu öffnen.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn die URL gesetzt wurde, oder mit einer Fehlermeldung abgelehnt wird, falls die Operation fehlschlägt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

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);

Hinweis: Diese API basiert auf der chrome.runtime API von Chromium. Diese Dokumentation stammt von runtime.json im Chromium-Code.