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 tables only load in the browser

示例

你可以像这样记录命令快捷键的更改:

js
function handleChanged(changeInfo) {
  console.log(`${changeInfo.name} 的快捷键已更改`);
  console.log(`从:${changeInfo.oldShortcut}`);
  console.log(`到:${changeInfo.newShortcut}`);
}

browser.commands.onChanged.addListener(handleChanged);