browserAction.onClicked

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

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

書式

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

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

addListener(listener)

このイベントのリスナーを追加します。

removeListener(listener)

このイベントのリスニングを停止します。引数listenerは削除するリスナーです。

hasListener(listener)

listenerがこのイベントに登録されているかどうかを調べます。trueが返ればリスニング中です。falseが返ればそうれはありません。

addListener の書式

パラメーター

callback

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

tab

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

ブラウザーの互換性

BCD tables only load in the browser

例

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

js
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 のもとにここに含まれています。