browserAction.onClicked
当浏览器操作图标被点击时触发。如果浏览器操作有一个弹出窗口,此事件将不会触发。
要定义右键单击操作,请使用 contextMenus
API,并使用 “browser_action” 上下文类型。
语法
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 语法
参数
listener
-
当此事件发生时调用的函数。该函数将传递以下参数
tab
-
tabs.Tab
。当图标被点击时处于活动状态的选项卡。 OnClickData
-
包含有关点击信息的 객체。
modifiers
-
array
。点击时处于活动状态的键盘修饰符,为Shift
、Alt
、Command
、Ctrl
或MacCtrl
之一或多个。 -
integer
。指示用于点击页面操作图标的按钮:0
代表左键单击或与鼠标无关的单击,例如来自键盘的单击,1
代表中间按钮或滚轮单击。请注意,右键单击不受支持,因为 Firefox 会消耗该单击以显示上下文菜单,然后才会触发此事件。
浏览器兼容性
BCD 表格仅在浏览器中加载
示例
当用户点击浏览器操作图标时,这段代码会将其关闭以用于活动选项卡,并记录选项卡的 URL
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);
});
示例扩展
- 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。此文档来自 browser_action.json
在 Chromium 代码中。