browserAction.onClicked

ブラウザアクションアイコンがクリックされたときに発火します。このイベントはブラウザアクションがポップアップを持っているときは発火しません。

右クリックを定義するには、contextMenus (en-US) API の"browser_action" context type (en-US)を利用してください。

書式

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

イベントは3つの関数を持っています:

addListener(listener)
このイベントのリスナーを追加します。
removeListener(listener)
このイベントのリスニングを停止します。引数listenerは削除するリスナーです。
hasListener(listener)
listenerがこのイベントに登録されているかどうかを調べます。trueが返ればリスニング中です。falseが返ればそうれはありません。

addListenerの書式

パラメータ

callback

イベントが発生したときに呼び出される関数です。関数は以下の引数を渡されます:

tab
tabs.Tab. アイコンがクリックされたときにアクティブなタブです。

ブラウザ互換性

BCD tables only load in the browser

ユーザがアイコンをクリックすると、アクティブなタブではアイコンを無効にし、タブのURLをログします:

browser.browserAction.onClicked.addListener((tab) => {
  // disable the active tab
  browser.browserAction.disable(tab.id);
  // requires the "tabs" or "activeTab" permission
  console.log(tab.url);
});

Example extensions

謝辞

このAPIはChromiumのchrome.browserAction APIに基づいています。このドキュメントはChromiumコードのbrowser_action.jsonから派生したものです。

Microsoft Edgeの互換性データはMicrosoft Corporationから提供されており、Creative Commons Attribution 3.0 United States Licenseのもとにここに含まれています。