management.setEnabled()

Включает или отключает заданный дополнение.

Эта функция обычно должна вызываться в контексте действия пользователя, например, обработчика клика по кнопке. Браузер также может попросить пользователя подтвердить изменение.

Для этого API требуется разрешение "management" API разрешение.

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

Функция позволяет включить/отключить дополнения темы, но вернёт ошибку, если используется для включения или отключения других типов веб-расширений.

Синтаксис

let settingEnabled = browser.management.setEnabled(
  id,              // string
  enabled         // boolean
)

Параметры

id: string. Идентификатор дополнения, которое нужно включить/отключить.
enabled: boolean. Нужно ли включить или отключить дополнение.

Значение возврата

A Promise, который будет выполнен без аргументов, когда дополнение будет отключено или включено.

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`setEnabled`	Да	79	55 Только расширения, у которых 'type' равно 'theme', могут быть включены и отключены.	?	Да	Нет	?	?	55 Только расширения, у которых 'type' равно 'theme', могут быть включены и отключены.	?	Нет	?

Примеры

Переключить включение/отключение дополнения, ID которого "my-add-on":

let id = "my-add-on";

function toggleEnabled(id) {
  let getting = browser.management.get(id);
  getting.then((info) => {
    browser.management.setEnabled(id, !info.enabled);
  });
}

toggleEnabled(id);

Примеры расширений

theme-switcher

Примечание: Это API основано на API chrome.management Chromium. Данная документация взята из management.json в коде Chromium.

© 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/management/setEnabled