chrome.extension

Описание

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

Типы

ViewType

Хром 44+

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

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

"вкладка"

"неожиданно возникнуть"

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

inIncognitoContext

Верно для скриптов контента, работающих внутри вкладок в режиме инкогнито, и для страниц расширений, работающих внутри процесса в режиме инкогнито. Последнее применимо только к расширениям с «разделённым» incognito_behavior.

Тип

булев

Методы

getBackgroundPage()

Только передний план
chrome.extension.getBackgroundPage(): Window | undefined

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

Возврат

  • Окно | не определено

getViews()

Только передний план
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

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

Параметры

  • fetchProperties

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

    • tabId

      номер необязательно

      Хром 54+

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

    • тип

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

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

    • windowId

      номер необязательно

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

Возврат

  • Окно[]

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

isAllowedFileSchemeAccess()

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

Возвращает состояние доступа расширения к схеме «file://». Это соответствует пользовательскому параметру «Разрешить доступ к URL-адресам файлов» для каждого расширения, доступному на странице chrome://extensions.

Возврат

  • Обещание<логическое>

    Хром 99+

isAllowedIncognitoAccess()

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

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

Возврат

  • Обещание<логическое>

    Хром 99+

setUpdateUrlData()

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

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

Параметры

  • данные

    нить

События