browserAction.onClicked

Wird ausgelöst, wenn ein Browseraktionssymbol angeklickt wird. Dieses Ereignis wird nicht ausgelöst, wenn die Browseraktion ein Popup hat.

Um eine Rechtsklickaktion zu definieren, verwenden Sie die contextMenus API mit dem "browser_action" Kontexttyp.

Syntax

js
browser.browserAction.onClicked.addListener(listener)
browser.browserAction.onClicked.removeListener(listener)
browser.browserAction.onClicked.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Stoppt das Lauschen dieses Ereignisses. 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 eintritt. Die Funktion erhält diese Argumente:

tab

tabs.Tab. Der Tab, der aktiv war, als das Symbol angeklickt wurde.

OnClickData

Ein Objekt, das Informationen über den Klick enthält.

modifiers

Ein array. Die Tastaturmodifikatoren, die zum Zeitpunkt des Klicks aktiv waren, eines oder mehrere von Shift, Alt, Command, Ctrl oder MacCtrl.

button

Ein integer. Gibt die Schaltfläche an, die zum Anklicken des Seitenaktionssymbols verwendet wurde: 0 für einen Linksklick oder einen Klick, der nicht mit einer Maus verbunden ist, wie zum Beispiel einer von der Tastatur, und 1 für einen Klick mit der mittleren Taste oder dem Rad. Beachten Sie, dass der Rechtsklick nicht unterstützt wird, da Firefox diesen Klick konsumiert, um das Kontextmenü anzuzeigen, bevor dieses Ereignis ausgelöst wird.

Browser-Kompatibilität

Beispiele

Wenn der Benutzer auf das Symbol der Browseraktion klickt, schaltet dieser Code die Aktion für den aktiven Tab ab und protokolliert die URL des Tabs:

js
browser.browserAction.onClicked.addListener((tab) => {
  // disable the browser action for the tab
  browser.browserAction.disable(tab.id);
  // requires the "tabs" or "activeTab" permission, or host permissions for the URL
  console.log(tab.url);
});

Beispielerweiterungen