commands.update()
Ändern Sie die Beschreibung oder Tastenkombination für den angegebenen Befehl.
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 dername
-Eigenschaft descommands.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
bisF19
zusätzlich zu den voncommands
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);