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。点击时处于活动状态的键盘修饰符,为 ShiftAltCommandCtrlMacCtrl 之一或多个。

button

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

示例扩展