browserAction.onClicked
ブラウザアクションアイコンがクリックされたときに発火します。このイベントはブラウザアクションがポップアップを持っているときは発火しません。
右クリックを定義するには、contextMenus
API の"browser_action" context typeを利用してください。
書式
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
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
例
ユーザがアイコンをクリックすると、アクティブなタブではアイコンを無効にし、タブの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
- bookmark-it
- favourite-colour
- find-across-tabs
- forget-it
- google-userinfo
- native-messaging
- open-my-page-button
- permissions
- runtime-examples
- store-collected-images
謝辞
このAPIはChromiumのchrome.browserAction
APIに基づいています。このドキュメントはChromiumコードのbrowser_action.json
から派生したものです。
Microsoft Edgeの互換性データはMicrosoft Corporationから提供されており、Creative Commons Attribution 3.0 United States Licenseのもとにここに含まれています。