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

瀏覽器相容性