commands.update()

語法

browser.commands.update(
  details // object
);

引數

details

object。一個具有以下屬性的物件。

name

string。要更新的命令的名稱。此名稱必須與現有命令的名稱匹配，例如在 commands.Command 物件的 name 屬性中指定的名稱。

description 可選

string。要為命令設定的新描述。

shortcut 可選

string。要為命令設定的新快捷方式。這可以是

• 一個空字串，用於清除快捷方式。
• 一個匹配 commands manifest.json 鍵 格式的字串，用於設定新的快捷方式鍵。如果字串不匹配此格式，則函式將丟擲錯誤。

  注意： 從 Firefox 135 開始，擴充套件可以使用此方法來分配 F13 到 F19 鍵，除了 commands 支援的鍵之外。

返回值

一個 Promise，當快捷方式已更新時，該 Promise 將會完成，不帶任何引數。如果找不到命令，Promise 將會以錯誤被拒絕。

示例

當用戶單擊“update”時，使用給定的快捷方式值更新名為“my-command”的命令。

const commandName = "my-command";

function updateShortcut() {
  browser.commands.update({
    name: commandName,
    shortcut: document.querySelector("#shortcut").value,
  });
}

document.querySelector("#update").addEventListener("click", updateShortcut);

擴充套件程式示例

• commands

瀏覽器相容性