menus.onClicked

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

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

Syntax

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

Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn es lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

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

info

menus.OnClickData. Informationen über das angeklickte Element und den Kontext, in dem der Klick stattfand.

tab

tabs.Tab. Die Details des Tabs, in dem der Klick stattfand. Falls der Klick nicht in oder auf einem Tab stattfand, fehlt dieser Parameter.

Browser-Kompatibilität

Beispiele

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

js
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

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