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 语法

参数

监听器

当命令的快捷键发生变化时调用的函数。该函数将接收以下参数:

changeInfo

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

name

string。命令的名称。这与 manifest.json 条目 中为该命令指定的名称匹配。

newShortcut

string。此命令的新活动快捷键,如果没有活动快捷键则为空字符串。

oldShortcut

string。此命令的活动快捷键,如果没有活动快捷键则为空字符串。

示例

您可以通过以下方式记录命令快捷键的更改:

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

浏览器兼容性