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