menus.onClicked

Wird ausgelöst, wenn ein Menüpunkt angeklickt wird.

Zur Kompatibilität mit anderen Browsern stellt Firefox dieses Ereignis sowohl über den Namespace contextMenus als auch über den Namespace menus zur Verfügung.

Syntax

browser.menus.onClicked.addListener(listener)
browser.menus.onClicked.removeListener(listener)
browser.menus.onClicked.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener): Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener): Stoppt das Lauschen auf dieses Ereignis. Das Argument listener ist der zu entfernende Listener.
hasListener(listener): Prüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn er aktiv lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion werden folgende Argumente übergeben:

info: menus.OnClickData. Informationen über das angeklickte Element und den Kontext, in dem der Klick erfolgt ist.
tab: tabs.Tab. Die Details des Tabs, in dem der Klick stattgefunden hat. Falls der Klick nicht in oder auf einem Tab erfolgte, fehlt dieses Parameter.

Beispiele

Dieses Beispiel hört auf Klicks auf ein Menüelement und protokolliert dann die ID des Elements und die Tab-ID:

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

browser.menus.onClicked.addListener((info, tab) => {
  console.log(`Item ${info.menuItemId} clicked in tab ${tab.id}`);
});

Beispielerweiterungen

Browser-Kompatibilität

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