menus.remove()

Entfernt ein Menüelement.

Für die Kompatibilität mit anderen Browsern stellt Firefox diese Methode sowohl im contextMenus-Namespace als auch im menus-Namespace zur Verfügung.

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

Syntax

js
let removing = browser.menus.remove(
  menuItemId      // integer or string
)

Parameter

integer oder string. Die ID des zu entfernenden Menüelements.

Rückgabewert

Ein Promise, das ohne Argumente erfüllt wird, wenn die Entfernung erfolgreich war, oder mit einer Fehlermeldung abgelehnt wird, wenn die Entfernung fehlgeschlagen ist (zum Beispiel, weil das Element nicht gefunden werden konnte).

Beispiele

Diese Erweiterung fügt ein Menüelement mit der Bezeichnung "Remove me!" hinzu. Wenn Sie auf das Element klicken, entfernt die Erweiterung es.

js
function onRemoved() {
  console.log("item removed successfully");
}

function onError() {
  console.log("error removing item:", browser.runtime.lastError);
}

browser.menus.create({
  id: "remove-me",
  title: "Remove me!",
  contexts: ["all"],
});

browser.menus.onClicked.addListener((info, tab) => {
  if (info.menuItemId === "remove-me") {
    let removing = browser.menus.remove(info.menuItemId);
    removing.then(onRemoved, onError);
  }
});

Beispielerweiterungen

Browser-Kompatibilität

Hinweis: Diese API basiert auf Chromiums chrome.contextMenus API. Diese Dokumentation ist abgeleitet von context_menus.json im Chromium-Code.