Spec-Zone.ru › Web Extensions

commands.update()

Изменить описание или сочетание клавиш для заданной команды.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

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

Параметры

details

object. Объект со следующими свойствами:

name

string. Имя команды для обновления. Оно должно совпадать с именем существующей команды, как указано, например, в свойстве name объекта commands.Command.

description Необязательно

string. Новое описание для команды.

shortcut Необязательно

string. Новое сочетание клавиш для команды. Оно может быть:

  • пустой строкой для удаления сочетания клавиш.
  • строкой, соответствующей формату ключа commands manifest.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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API