commands.update()

Syntax

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

Parameter

details

object. Ein Objekt mit den folgenden Eigenschaften:

name

string. Der Name des zu aktualisierenden Befehls. Dieser muss mit dem Namen eines vorhandenen 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 Abkürzung, die für den Befehl festgelegt werden soll. Dies kann sein:

• ein leerer String, um die Abkürzung zu löschen.
• ein String, der dem Format des commands manifest.json key entspricht, um eine neue Abkürzungstaste 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.

Rückgabewert

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

Beispiele

Aktualisiert den Befehl namens "my-command" mit dem angegebenen Abkürzungswert, 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);

Beispielerweiterungen

• commands

Browser-Kompatibilität