расширение

Утилиты, связанные с вашим расширением. Получите URL-адреса пакетов ресурсов с вашим расширением. Получите объект Window для страниц вашего расширения. Получите значения различных настроек.

Примечание: API обмена сообщениями в этом модуле устарели в пользу эквивалентных API в модуле runtime.

Типы

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

Свойства

extension.lastError Устарело: Устанавливается на время выполнения обратного вызова, если асинхронный API расширения привёл к ошибке. Если ошибка не произошла, lastError будет undefined.
extension.inIncognitoContext: True для скриптов содержимого, выполняемых внутри вкладок инкогнито, и для страниц расширения, выполняемых внутри процесса инкогнито. (Последнее относится только к расширениям с 'split' incognito_behavior.)

Функции

extension.getBackgroundPage(): Возвращает объект Window для страницы фона, работающей внутри текущего расширения. Возвращает null, если у расширения нет страницы фона.
extension.getExtensionTabs() Устарело: Возвращает массив JavaScript-объектов Window для каждой вкладки, работающей внутри текущего расширения.
extension.getURL() Устарело: Преобразует относительный путь внутри каталога установки расширения в полностью квалифицированный URL.
extension.getViews(): Возвращает массив объектов Window для каждой страницы, работающей внутри текущего расширения.
extension.isAllowedIncognitoAccess(): Получает состояние доступа расширения к режиму инкогнито (определяется пользователем с помощью чекбокса «Разрешить в инкогнито»).
extension.isAllowedFileSchemeAccess(): Получает состояние доступа расширения к схеме file:// (определяется пользователем с помощью чекбокса «Разрешить доступ к URL-адресам File»).
extension.sendRequest() Устарело: Отправляет один запрос другим слушателям внутри расширения.
extension.setUpdateUrlData(): Устанавливает значение параметра ap CGI, используемого в URL-адресе обновления расширения. Это значение игнорируется для расширений, размещённых в магазине поставщика браузера.

События

extension.onRequest Устарело: Срабатывает при отправке запроса из процесса расширения или скрипта содержимого.
extension.onRequestExternal Устарело: Срабатывает при отправке запроса из другого расширения.

Совместимость с браузерами

	Рабочий стол						Мобильные
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`ViewType`	Да	79	45	?	Да	14	?	?	48	?	15	?
`getBackgroundPage`	Да	14	45	?	Да	14	?	?	48	?	15	?
`getExtensionTabs`	Да	79	Нет	?	Нет	Нет	?	?	Нет	?	Нет	?
`getURL`	Да	14	45	?	Да	14	?	?	48	?	15	?
`getViews`	Да	14	45 Если вызов производится со страницы, которая является частью частного окна просмотра, например, боковой панели в частном окне или всплывающего окна, открытого из частного окна, то возвращаемое значение не будет включать страницу фона расширения.	?	Да	14	?	?	48 Если вызов производится со страницы, которая является частью частного окна просмотра, например, боковой панели в частном окне или всплывающего окна, открытого из частного окна, то возвращаемое значение не будет включать страницу фона расширения.	?	15	?
`inIncognitoContext`	Да	17	45	?	Да	14 Всегда возвращает false.	?	?	48	?	15 Всегда возвращает false.	?
`isAllowedFileSchemeAccess`	Да	79	48	?	Да	14 Всегда возвращает false.	?	?	48	?	15 Всегда возвращает false.	?
`isAllowedIncognitoAccess`	Да	17	48	?	Да	14 Всегда возвращает true.	?	?	48	?	15 Всегда возвращает true.	?
`lastError`	Да	79	47	?	Да	Нет	?	?	48	?	Нет	?
`onRequest`	Да	79	Нет	?	Да	Нет	?	?	Нет	?	Нет	?
`onRequestExternal`	Да	79	Нет	?	Да	Нет	?	?	Нет	?	Нет	?
`sendRequest`	Да	79	Нет	?	Нет	Нет	?	?	Нет	?	Нет	?
`setUpdateUrlData`	Да	79	Нет	?	Да	Нет	?	?	Нет	?	Нет	?

END_OF_DOCUMENT_MARKER

Примеры расширений

Примечание: Этот API основан на API chrome.extension Chromium. Данная документация взята из extension.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/extension