chrome.extension

Описание

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

Типы

ViewType

Хром 44+

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

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

"вкладка"

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

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

inIncognitoContext

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

Тип

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

Методы

getBackgroundPage()

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

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

Возврат

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

getViews()

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

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

Параметры

  • выборка свойств

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

    • идентификатор табуляции

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

      Хром 54+

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

    • тип

      Тип представления необязательно

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

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

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

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

Возврат

  • Окно[]

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

isAllowedFileSchemeAccess()

Обещать
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

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

Параметры

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

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

    Параметр callback выглядит так: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

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

      True, если расширение может получить доступ к схеме «file://», в противном случае — false.

Возврат

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

    Хром 99+

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

isAllowedIncognitoAccess()

Обещать
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

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

Параметры

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

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

    Параметр callback выглядит так: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

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

      True, если расширение имеет доступ к режиму инкогнито, в противном случае — false.

Возврат

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

    Хром 99+

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

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

Параметры

  • данные

    нить

События