хром.менеджмент

дата обновления: 2026-09-25 robots: noindex

Описание

API chrome.management предоставляет способы управления установленными приложениями и расширениями.

Разрешения

management

Манифест

Для использования API управления необходимо указать разрешение "management" в манифесте расширения . Например:

{
  "name": "My extension",
  ...
  "permissions": [
    "management"
  ],
  ...
}

management.getPermissionWarningsByManifest , management.uninstallSelf и management.getSelf не требуют наличия разрешения на управление.

Типы

ExtensionDisabledReason

Chrome 44+

Причина отключения данного элемента.

Перечисление

"неизвестный"

"permissions_increase"

ExtensionInfo

Информация об установленном расширении, приложении или теме оформления.

Характеристики

  • appLaunchUrl

    строка необязательный

    URL-адрес запуска (присутствует только для приложений).

  • availableLaunchTypes

    LaunchType [] необязательный

    Доступные в данный момент типы запуска (присутствуют только для приложений).

  • описание

    нить

    Описание этого расширения, приложения или темы.

  • disabledReason

    ExtensionDisabledReason optional

    Причина отключения данного элемента.

  • включено

    логический

    Включена или отключена в данный момент.

  • адрес главной страницы

    строка необязательный

    URL главной страницы этого расширения, приложения или темы.

  • hostPermissions

    нить[]

    Возвращает список разрешений на основе хоста.

  • иконки

    IconInfo [] необязательный

    Список информации об иконках. Обратите внимание, что это отражает только то, что было заявлено в манифесте, и фактическое изображение по этому URL-адресу может быть больше или меньше, чем было заявлено, поэтому вы можете рассмотреть возможность использования явных атрибутов ширины и высоты в тегах img, ссылающихся на эти изображения. Более подробную информацию см. в документации по иконкам в манифесте .

  • идентификатор

    нить

    Уникальный идентификатор расширения.

  • Как было установлено расширение.

  • приложение

    логический

    Устаревший

    Пожалуйста, используйте management.ExtensionInfo.type .

    Верно, если это приложение.

  • launchType

    LaunchType ( необязательный параметр)

    Тип запуска приложения (присутствует только для приложений).

  • mayDisable

    логический

    Возможность отключения или удаления данного расширения пользователем.

  • mayEnable

    логический необязательный

    Chrome 62+

    Указывает, может ли пользователь включить это расширение. Этот параметр возвращается только для расширений, которые не включены.

  • имя

    нить

    Название этого расширения, приложения или темы.

  • offlineEnabled

    логический

    Независимо от того, заявляет ли расширение, приложение или тема о поддержке работы в автономном режиме.

  • optionsUrl

    нить

    URL страницы с настройками товара, если таковая имеется.

  • разрешения

    нить[]

    Возвращает список разрешений, основанных на API.

  • короткое имя

    нить

    Сокращенное название этого расширения, приложения или темы.

  • Тип этого расширения, приложения или темы.

  • updateUrl

    строка необязательный

    URL-адрес обновления этого расширения, приложения или темы.

  • версия

    нить

    Версия этого расширения, приложения или темы.

  • versionName

    строка необязательный

    Chrome 50+

    Название версии этого расширения, приложения или темы, если оно указано в манифесте.

ExtensionInstallType

Chrome 44+

Способ установки расширения. Один из вариантов: admin : расширение было установлено в соответствии с политикой администратора; development : расширение было загружено в распакованном виде в режиме разработчика; normal : расширение было установлено обычным способом через файл .crx; sideload : расширение было установлено другим программным обеспечением на компьютере; other : расширение было установлено иным способом.

Перечисление

"админ"

"разработка"

"нормальный"

"боковая загрузка"

"другой"

ExtensionType

Chrome 44+

Тип этого расширения, приложения или темы.

Перечисление

"расширение"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"тема"

"login_screen_extension"

IconInfo

Информация об иконке, относящейся к расширению, приложению или теме оформления.

Характеристики

  • размер

    число

    Число, обозначающее ширину и высоту значка. Вероятные значения включают (но не ограничиваются ими) 128, 48, 24 и 16.

  • url

    нить

    URL-адрес изображения значка. Чтобы отобразить версию значка в оттенках серого (например, чтобы указать, что расширение отключено), добавьте к URL-адресу ?grayscale=true .

LaunchType

Это все возможные типы запуска приложений.

Перечисление

"ОТКРЫТЬ КАК ОБЫЧНУЮ ВКЛАДКУ"

"ОТКРЫТЬ КАК ЗАКРЕПЛЕННАЯ ВКЛАДКА"

"ОТКРЫТЬ_КАК_ОКНО"

"ОТКРЫТЬ_ПОЛНЫЙ_ЭКРАН"

UninstallOptions

Chrome 88+

Варианты удаления расширения.

Характеристики

  • showConfirmDialog

    логический необязательный

    Определяет, следует ли отображать диалоговое окно подтверждения удаления для пользователя. По умолчанию — false для самостоятельного удаления. Если расширение удаляет другое расширение, этот параметр игнорируется, и диалоговое окно всегда отображается.

Методы

createAppShortcut()

Обещать
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

Отображение параметров для создания ярлыков для приложения. На Mac можно создавать только ярлыки для упакованных приложений.

Параметры

  • идентификатор

    нить

    Это должен быть идентификатор элемента приложения из management.ExtensionInfo .

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

Обещать
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

Сгенерировать приложение для указанного URL-адреса. Возвращает сгенерированное приложение-закладку.

Параметры

  • url

    нить

    URL веб-страницы. Схема URL может быть только "http" или "https".

  • заголовок

    нить

    Название сгенерированного приложения.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (result: ExtensionInfo) => void

Возвраты

  • Promise< ExtensionInfo >

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

get()

Обещать
chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

Возвращает информацию об установленном расширении, приложении или теме, имеющих заданный идентификатор.

Параметры

  • идентификатор

    нить

    Идентификатор элемента из management.ExtensionInfo .

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (result: ExtensionInfo) => void

Возвраты

  • Promise< ExtensionInfo >

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getAll()

Обещать
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

Возвращает список информации об установленных расширениях и приложениях.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (result: ExtensionInfo[]) => void

Возвраты

  • Promise< ExtensionInfo []>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getPermissionWarningsById()

Обещать
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

Возвращает список предупреждений о разрешениях для заданного идентификатора расширения.

Параметры

  • идентификатор

    нить

    Идентификатор уже установленного расширения.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      нить[]

Возвраты

  • Promise<string[]>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getPermissionWarningsByManifest()

Обещать
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

Возвращает список предупреждений о разрешениях для заданной строки манифеста расширения. Примечание: эту функцию можно использовать без запроса разрешения 'management' в манифесте.

Параметры

  • manifestStr

    нить

    Строка JSON манифеста расширения.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (permissionWarnings: string[]) => void

    • permissionWarnings

      нить[]

Возвраты

  • Promise<string[]>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getSelf()

Обещать
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

Возвращает информацию о вызывающем расширении, приложении или теме оформления. Примечание: эту функцию можно использовать без запроса разрешения «управление» в манифесте.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    (result: ExtensionInfo) => void

Возвраты

  • Promise< ExtensionInfo >

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

installReplacementWebApp()

Promise Chrome 77+
chrome.management.installReplacementWebApp(
  callback?: function,
): Promise<void>

Запускает заменяющее веб-приложение, указанное в манифесте. Предлагает пользователю установить его, если оно еще не установлено.

Параметры

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

launchApp()

Обещать
chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

Запускает приложение.

Параметры

  • идентификатор

    нить

    Идентификатор расширения приложения.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

setEnabled()

Обещать
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

Включает или отключает приложение или расширение. В большинстве случаев эта функция должна вызываться в контексте действия пользователя (например, обработчик события onclick для кнопки) и может отображать пользователю стандартный интерфейс подтверждения, чтобы предотвратить злоупотребления.

Параметры

  • идентификатор

    нить

    Это должен быть идентификатор элемента из management.ExtensionInfo .

  • включено

    логический

    Включить или отключить этот элемент.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

setLaunchType()

Обещать
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

Укажите тип запуска приложения.

Параметры

  • идентификатор

    нить

    Это должен быть идентификатор элемента приложения из management.ExtensionInfo .

  • launchType

    LaunchType

    Целевой тип запуска. Всегда проверяйте и убедитесь, что этот тип запуска присутствует в ExtensionInfo.availableLaunchTypes , поскольку доступные типы запуска различаются на разных платформах и в разных конфигурациях.

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

uninstall()

Обещать
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

Удаляет установленное приложение или расширение. Примечание: Эта функция не работает в управляемых средах, если пользователю не разрешено удалять указанное расширение/приложение. Если удаление не удается (например, пользователь отменяет диалоговое окно), промис будет отклонен или будет вызвана функция обратного вызова с установленным значением runtime.lastError .

Параметры

  • идентификатор

    нить

    Это должен быть идентификатор элемента из management.ExtensionInfo .

  • параметры

    UninstallOptions ( необязательно)

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

uninstallSelf()

Обещать
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

Удаляет вызывающее расширение. Примечание: Эту функцию можно использовать без запроса разрешения на «управление» в манифесте. Эта функция не работает в управляемых средах, если пользователю не разрешено удалять указанное расширение/приложение.

Параметры

  • параметры

    UninstallOptions ( необязательно)

  • перезвонить

    функция необязательна

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 88+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

События

onDisabled

chrome.management.onDisabled.addListener(
  callback: function,
)

Срабатывает при отключении приложения или расширения.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (info: ExtensionInfo) => void

onEnabled

chrome.management.onEnabled.addListener(
  callback: function,
)

Событие срабатывает при включении приложения или расширения.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (info: ExtensionInfo) => void

onInstalled

chrome.management.onInstalled.addListener(
  callback: function,
)

Срабатывает при установке приложения или расширения.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (info: ExtensionInfo) => void

onUninstalled

chrome.management.onUninstalled.addListener(
  callback: function,
)

Срабатывает при удалении приложения или расширения.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (id: string) => void

    • идентификатор

      нить