browser.extension

Описание

API chrome.extension содержит утилиты, которые можно использовать на любой странице расширения. В частности, он позволяет обмениваться сообщениями между расширением и его скриптами контента или между расширениями, как описано в статье Передача сообщений.

Типы

ViewType

Chrome 44+ browser.* начиная с Chrome 148

Тип представления расширения.

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

"tab"

"popup"

Свойства

inIncognitoContext

Значение True для скриптов контента, запущенных на вкладках инкогнито, и для страниц расширений, запущенных в процессе инкогнито. Последнее относится только к расширениям с incognito_behavior, равным split.

Тип

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

Методы

getBackgroundPage()

Только в активном режиме 
browser.extension.getBackgroundPage(): Window | undefined

Возвращает объект window JavaScript для фоновой страницы, которая выполняется в текущем расширении. Возвращает null, если у расширения нет фоновой страницы.

Возвраты

  • Window | undefined

getViews()

Только в активном режиме 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

Возвращает массив объектов window JavaScript для каждой страницы, запущенной в текущем расширении.

Параметры

  • fetchProperties

    Объект (необязательно)

    • tabId

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

      Chrome 54+ browser.* начиная с Chrome 148

      Найти представление по идентификатору вкладки. Если это поле не заполнено, возвращаются все представления.

    • тип

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

      Тип представления, которое нужно получить. Если не указано, возвращает все представления (включая фоновые страницы и вкладки).

    • windowId

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

      Окно, в котором будет выполняться поиск. Если этот параметр не указан, возвращаются все представления.

Возвраты

  • Window[]

    Массив глобальных объектов

isAllowedFileSchemeAccess()

browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>

Получает статус доступа расширения к схеме file://. Это соответствует настройке "Разрешить открывать локальные файлы по ссылкам", которая задается пользователем для каждого расширения на странице chrome://extensions.

Возвраты

  • Promise<boolean>

    Chrome 99 и более поздние версии browser.* начиная с Chrome 148

isAllowedIncognitoAccess()

browser.extension.isAllowedIncognitoAccess(): Promise<boolean>

Получает состояние доступа расширения к режиму инкогнито. Это соответствует настройке "Разрешить использование в режиме инкогнито" для каждого расширения, доступной на странице chrome://extensions.

Возвраты

  • Promise<boolean>

    Chrome 99 и более поздние версии browser.* начиная с Chrome 148

setUpdateUrlData()

browser.extension.setUpdateUrlData(
  data: string,
): void

Задает значение параметра CGI ap, который используется в URL обновления расширения. Это значение игнорируется для расширений, размещенных в галерее расширений Chrome.

Параметры

  • делал.

    string