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

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

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

addListener の書式

パラメーター

callback

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

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

例

ユーザーがアイコンをクリックすると、アクティブなタブではアイコンを無効にし、タブの 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);
});

メモ: この API は Chromium のchrome.browserAction API に基づいています。このドキュメントは Chromium コードのbrowser_action.jsonから派生したものです。Microsoft Edge の互換性データは Microsoft Corporation から提供されており、Creative Commons Attribution 3.0 United States License のもとにここに含まれています。

browserAction.onClicked

書式

addListener の書式

パラメーター

ブラウザーの互換性

例

Example extensions