menus.getTargetElement()

Gibt das Element für eine gegebene targetElementId zurück.

Diese Methode ist in allen Erweiterungsskript-Kontexten verfügbar (Inhalts-Skripte, Hintergrundseiten und andere Erweiterungsseiten) und gibt das Element für eine gegebene info.targetElementId zurück, vorausgesetzt, das Element existiert noch im Dokument, in dem die Methode aufgerufen wird.

Die Methode funktioniert nur in dem Dokument, das das mit der rechten Maustaste angeklickte Element enthält, und die targetElementId verfällt, wenn der Benutzer ein anderes Kontextmenü öffnet.

Hinweis: menus.getTargetElement gibt das angeforderte Element nur zurück, wenn es im selben Kontext wie das Dokument, das das Element enthält, aufgerufen wird, zum Beispiel unter Verwendung von Inhalts-Skripten (wie im folgenden Beispiel gezeigt).

Eine Erweiterung benötigt die Berechtigung "menus", um diese API zu verwenden.

Syntax

let elem = browser.menus.getTargetElement(targetElementId);

Parameter

targetElementId: Die Eigenschaft des menus.OnClickData Objekts, das an den menus.onClicked Handler oder das menus.onShown Ereignis übergeben wird.

Rückgabewert

Das durch den targetElementId Parameter referenzierte Element. Wenn der targetElementId Parameter nicht gültig ist, gibt die Methode null zurück.

Beispiele

Das folgende Beispiel verwendet die getTargetElement Methode, um das durch die info.targetElementId Eigenschaft referenzierte Element zu erhalten und es anschließend zu entfernen.

browser.menus.create({
  title: "Remove element",
  documentUrlPatterns: ["*://*/*"],
  contexts: [
    "audio",
    "editable",
    "frame",
    "image",
    "link",
    "page",
    "password",
    "video",
  ],
  onclick(info, tab) {
    browser.tabs.executeScript(tab.id, {
      frameId: info.frameId,
      code: `browser.menus.getTargetElement(${info.targetElementId}).remove();`,
    });
  },
});

Beispielerweiterungen

menu-remove-element