contentScripts
Используйте этот API для регистрации скриптов содержимого. Регистрация скрипта содержимого инструктирует браузер вставлять заданные скрипты содержимого на страницы, соответствующие заданным шаблонам URL.
Примечание: При использовании Manifest V3 или выше, используйте scripting.registerContentScripts() для регистрации скриптов.
Этот API очень похож на ключ "content_scripts" manifest.json, за исключением того, что при использовании "content_scripts", набор скриптов содержимого и связанных шаблонов фиксируется во время установки. При использовании API contentScripts, расширение может регистрировать и отключать скрипты во время выполнения.
Для использования API вызовите contentScripts.register(), передав объект, определяющий регистрируемые скрипты, шаблоны URL и другие параметры. Это возвращает Promise, который разрешается объектом contentScripts.RegisteredContentScript.
Объект RegisteredContentScript представляет собой скрипты, которые были зарегистрированы в вызове register(). Он определяет метод unregister() , который вы можете использовать для отключения скриптов содержимого. Скрипты содержимого также отключаются автоматически, когда страница, которая их создала, уничтожается. Например, если они зарегистрированы из страницы фона, они будут отключены автоматически при уничтожении страницы фона, а если они зарегистрированы из боковой панели или всплывающего окна, они будут отключены автоматически при закрытии боковой панели или всплывающего окна.
API contentScripts разрешений нет, но расширение должно иметь соответствующие разрешения на доступ к хосту для любых шаблонов, которые оно передает в register().
Типы
contentScripts.RegisteredContentScript-
Объект этого типа возвращается функцией
contentScripts.register(). Он представляет скрипты содержимого, которые были зарегистрированы этим вызовом, и может использоваться для отключения скрипта содержимого.
Функции
contentScripts.register()-
Регистрирует заданные скрипты содержимого.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
RegisteredContentScript |
Нет | Нет | 59 | ? | Нет | Нет | ? | ? | 59 | ? | Нет | ? |
register |
Нет | Нет | 59 | ? | Нет | Нет | ? | ? | 59 | ? | Нет | ? |
Примеры расширений
© 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/contentScripts