commands.update()
Изменить описание или сочетание клавиш для заданной команды.
Это асинхронная функция, которая возвращает Promise.
Синтаксис
browser.commands.update( details // object );
Параметры
details-
object. Объект со следующими свойствами:name-
string. Имя команды для обновления. Оно должно совпадать с именем существующей команды, как указано, например, в свойствеnameобъектаcommands.Command. -
descriptionНеобязательно -
string. Новое описание для команды. -
shortcutНеобязательно -
string. Новое сочетание клавиш для команды. Оно может быть:- пустой строкой для удаления сочетания клавиш.
- строкой, соответствующей формату ключа
commandsmanifest.json для задания новой клавиши сочетания. Если строка не соответствует этому формату, функция возвращает ошибку.
Возвращаемое значение
A Promise, который будет выполнен без аргументов, когда сочетание клавиш будет обновлено. Обещание будет отклонено с ошибкой, если команда не найдена.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
update |
Нет | Нет | 60 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
Примеры
Обновляет команду с именем "my-command" заданным значением сочетания клавиш при нажатии "обновить":
const commandName = 'my-command'; function updateShortcut() { browser.commands.update({ name: commandName, shortcut: document.querySelector('#shortcut').value }); } document.querySelector('#update').addEventListener('click', updateShortcut);
Примеры расширений
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/commands/update