commands.update()

details

object. Ein Objekt mit den folgenden Eigenschaften:

name

string. Der Name des zu aktualisierenden Befehls. Dieser muss mit dem Namen eines bestehenden Befehls übereinstimmen, wie er beispielsweise in der name-Eigenschaft des commands.Command Objekts angegeben ist.

description Optional

string. Eine neue Beschreibung, die für den Befehl festgelegt werden soll.

shortcut Optional

string. Eine neue Tastenkombination, die für den Befehl festgelegt werden soll. Diese kann sein:

• ein leerer String, um die Tastenkombination zu löschen.
• ein String, der dem Format des commands manifest.json Schlüssels entspricht, um eine neue Tastenkombination festzulegen. Wenn der String dieses Format nicht erfüllt, löst die Funktion einen Fehler aus.

  Hinweis: Ab Firefox 135 können Erweiterungen mit dieser Methode die Tasten F13 bis F19 zusätzlich zu den von commands unterstützten Tasten zuweisen.

Ein Promise, das ohne Argumente erfüllt wird, wenn die Tastenkombination aktualisiert wurde. Das Promise wird mit einem Fehler abgelehnt, wenn der Befehl nicht gefunden werden konnte.

Aktualisiert den Befehl mit dem Namen "my-command" mit dem angegebenen Shortcut-Wert, wenn der Benutzer auf "update" klickt:

const commandName = "my-command";

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

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

• commands