onCommand

當使用命令的關聯鍵盤快捷鍵執行命令時觸發。

監聽器將接收命令的名稱。這與在 manifest.json 條目中為命令指定的名稱相匹配。

語法

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

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查 listener 是否已為此事件註冊。如果正在監聽,則返回 true,否則返回 false

addListener 語法

引數

監聽器

當用戶輸入命令的快捷方式時呼叫的函式。該函式將接收以下引數

name

string. 命令的名稱。這與在 manifest.json 條目中為命令指定的名稱相匹配。

tab

tabs.Tab. 輸入命令快捷方式時處於活動狀態的標籤頁。

示例

給定一個像這樣的 manifest.json 條目

json
"commands": {
  "toggle-feature": {
    "suggested_key": {
      "default": "Ctrl+Shift+Y"
    },
    "description": "Send a 'toggle-feature' event"
  }
}

你可以像這樣監聽這個特定的命令

js
browser.commands.onCommand.addListener((command) => {
  if (command === "toggle-feature") {
    console.log("toggling the feature!");
  }
});

擴充套件程式示例

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.commands API。