onChanged

当命令的键盘快捷键发生更改时触发。

侦听器将传递一个包含命令名称、其新的活动快捷键及其旧快捷键的对象。

语法

js
browser.commands.onChanged.addListener(listener)
browser.commands.onChanged.removeListener(listener)
browser.commands.onChanged.hasListener(listener)

事件具有三个函数

addListener(listener)

向此事件添加侦听器。

removeListener(listener)

停止侦听此事件。listener 参数是要删除的侦听器。

hasListener(listener)

检查listener 是否为此事件注册。如果正在侦听,则返回true,否则返回false

addListener 语法

参数

listener

当命令的快捷键发生更改时调用的函数。该函数传递以下参数

changeInfo

object。一个包含命令名称、其新的活动快捷键及其旧快捷键的对象。

name

string。命令名称。这与在 manifest.json 条目 中给出的命令名称匹配。

newShortcut

string。此命令的新活动快捷键,如果无快捷键处于活动状态,则为空。

oldShortcut

string。为此命令处于活动状态的快捷键,如果无快捷键处于活动状态,则为空。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

您可以像这样记录对命令快捷键的更改

js
function handleChanged(changeInfo) {
  console.log(`Shortcut for: ${changeInfo.name} changed`);
  console.log(`From: ${changeInfo.oldShortcut}`);
  console.log(`To: ${changeInfo.newShortcut}`);
}

browser.commands.onChanged.addListener(handleChanged);