chrome.management

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

management

Манифест

Чтобы использовать Management API, необходимо объявить разрешение management в манифесте расширения. Пример:

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

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

Типы

ExtensionDisabledReason

Chrome 44 и более поздних версий;

Причина, по которой объект отключен.

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

"unknown"

"permissions_increase"

ExtensionInfo

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

Свойства

  • appLaunchUrl

    Строка (необязательно)

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

  • availableLaunchTypes

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

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

  • описание

    string

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

  • disabledReason

    ExtensionDisabledReason необязательный

    Причина, по которой объект отключен.

  • включено

    Логическое значение

    Включено ли оно в настоящее время.

  • homepageUrl

    Строка (необязательно)

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

  • hostPermissions

    string[]

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

  • значки

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

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

  • id

    string

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

  • installType

    ExtensionInstallType

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

  • isApp

    Логическое значение

    Поддержка прекращена

    Используйте management.ExtensionInfo.type.

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

  • launchType

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

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

  • mayDisable

    Логическое значение

    Может ли пользователь отключить или удалить это расширение.

  • mayEnable

    Логическое значение (необязательно)

    Chrome 62 и более поздних версий

    Может ли пользователь включить это расширение. Возвращается только для отключенных расширений.

  • name

    string

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

  • offlineEnabled

    Логическое значение

    Поддерживает ли расширение, приложение или тема офлайн-режим.

  • optionsUrl

    string

    URL страницы настроек объекта (если она есть).

  • разрешения

    string[]

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

  • shortName

    string

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

  • тип

    ExtensionType

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

  • updateUrl

    Строка (необязательно)

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

  • version

    string

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

  • versionName

    Строка (необязательно)

    Chrome 50 и более поздних версий;

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

ExtensionInstallType

Chrome 44 и более поздних версий;

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

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

"admin"

"development"

"normal"

"sideload"

"other"

ExtensionType

Chrome 44 и более поздних версий;

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

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

"extension"

"hosted_app"

"packaged_app"

"legacy_packaged_app"

"theme"

"login_screen_extension"

IconInfo

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

Свойства

  • размер

    число

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

  • url

    string

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

LaunchType

Ниже перечислены все возможные типы запуска приложения.

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

"OPEN_AS_REGULAR_TAB"

"OPEN_AS_PINNED_TAB"

"OPEN_AS_WINDOW"

"OPEN_FULL_SCREEN"

UninstallOptions

Chrome 88 и более поздних версий;

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

Свойства

  • showConfirmDialog

    Логическое значение (необязательно)

    Должно ли показываться диалоговое окно с подтверждением удаления. Значение по умолчанию для самостоятельного удаления – false. Если расширение удаляет другое расширение, этот параметр игнорируется и диалоговое окно показывается всегда.

Методы

createAppShortcut()

Promise 
chrome.management.createAppShortcut(
  id: string,
  callback?: function,
): Promise<void>

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

Параметры

  • id

    string

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

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

Promise 
chrome.management.generateAppForLink(
  url: string,
  title: string,
  callback?: function,
): Promise<ExtensionInfo>

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

Параметры

  • url

    string

    URL веб-страницы. В URL можно использовать только протоколы http и https.

  • название

    string

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

  • обратный вызов

    function необязательно

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

    (result: ExtensionInfo) => void

Возвраты

  • Promise<ExtensionInfo>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

get()

Promise 
chrome.management.get(
  id: string,
  callback?: function,
): Promise<ExtensionInfo>

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

Параметры

  • id

    string

    Идентификатор товара из management.ExtensionInfo.

  • обратный вызов

    function необязательно

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

    (result: ExtensionInfo) => void

Возвраты

  • Promise<ExtensionInfo>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getAll()

Promise 
chrome.management.getAll(
  callback?: function,
): Promise<ExtensionInfo[]>

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

Параметры

  • обратный вызов

    function необязательно

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

    (result: ExtensionInfo[]) => void

Возвраты

  • Promise<ExtensionInfo[]>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getPermissionWarningsById()

Promise 
chrome.management.getPermissionWarningsById(
  id: string,
  callback?: function,
): Promise<string[]>

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

Параметры

  • id

    string

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

  • обратный вызов

    function необязательно

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

Возвраты

  • Promise<string[]>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getPermissionWarningsByManifest()

Promise 
chrome.management.getPermissionWarningsByManifest(
  manifestStr: string,
  callback?: function,
): Promise<string[]>

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

Параметры

  • manifestStr

    string

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

  • обратный вызов

    function необязательно

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

    (permissionWarnings: string[]) => void

    • permissionWarnings

      string[]

Возвраты

  • Promise<string[]>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getSelf()

Promise 
chrome.management.getSelf(
  callback?: function,
): Promise<ExtensionInfo>

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

Параметры

  • обратный вызов

    function необязательно

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

    (result: ExtensionInfo) => void

Возвраты

  • Promise<ExtensionInfo>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

installReplacementWebApp()

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

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

Параметры

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

launchApp()

Promise 
chrome.management.launchApp(
  id: string,
  callback?: function,
): Promise<void>

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

Параметры

  • id

    string

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

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

setEnabled()

Promise 
chrome.management.setEnabled(
  id: string,
  enabled: boolean,
  callback?: function,
): Promise<void>

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

Параметры

  • id

    string

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

  • включено

    Логическое значение

    Должен ли этот элемент быть включен или отключен.

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

setLaunchType()

Promise 
chrome.management.setLaunchType(
  id: string,
  launchType: LaunchType,
  callback?: function,
): Promise<void>

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

Параметры

  • id

    string

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

  • launchType

    LaunchType

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

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

uninstall()

Promise 
chrome.management.uninstall(
  id: string,
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

Параметры

  • id

    string

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

  • Параметры

    UninstallOptions необязательный

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

uninstallSelf()

Promise 
chrome.management.uninstallSelf(
  options?: UninstallOptions,
  callback?: function,
): Promise<void>

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

Параметры

  • Параметры

    UninstallOptions необязательный

  • обратный вызов

    function необязательно

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

    () => void

Возвраты

  • Promise<void>

    Chrome 88 и более поздних версий;

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onDisabled

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

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

Параметры

  • обратный вызов

    function

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

    (info: ExtensionInfo) => void

onEnabled

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

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

Параметры

  • обратный вызов

    function

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

    (info: ExtensionInfo) => void

onInstalled

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

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

Параметры

  • обратный вызов

    function

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

    (info: ExtensionInfo) => void

onUninstalled

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

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

Параметры

  • обратный вызов

    function

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

    (id: string) => void

    • id

      string