menus.remove()

Entfernt ein Menüelement.

Um die Kompatibilität mit anderen Browsern zu gewährleisten, stellt Firefox diese Methode sowohl über den Namespace contextMenus als auch über den Namespace menus bereit.

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, wenn die Entfernung fehlschlug (zum Beispiel, weil das Element nicht gefunden werden konnte).

Beispiele

Diese Erweiterung fügt ein Menüelement mit der Beschriftung "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

BCD tables only load in the browser

Hinweis: Diese API basiert auf Chromiums chrome.contextMenus API. Diese Dokumentation stammt aus context_menus.json im Chromium-Code.