scripting.registerContentScripts()

Регистрирует один или несколько скриптов контента.

Примечание: Этот метод доступен в Manifest V3 или выше в Chrome и Firefox 101. В Firefox 102+ этот метод также доступен в Manifest V2.

Для использования этого API необходимо иметь разрешение "scripting" разрешение и разрешение на URL страницы, либо явно в виде разрешения на хост, либо с использованием разрешения activeTab.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

await browser.scripting.registerContentScripts(
  scripts         // array
)

Параметры

scripts: array scripting.RegisteredContentScript. Список скриптов для регистрации.

Возвращаемое значение

A Promise который выполняется с массивом scripting.RegisteredContentScript. Если при разборе скриптов и проверке файлов возникнут ошибки или если указанные ID не существуют, скрипты не регистрируются, а обещание отклоняется.

Примеры

В этом примере регистрируется скрипт контента, который вставляет файл "script.js":

const aScript = {
  id: "a-script",
  js: ["script.js"],
  matches: ["https://example.com/*"],
};

try {
  await browser.scripting.registerContentScripts([aScript]);
} catch (err) {
  console.error(`failed to register content scripts: ${err}`);
}

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

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`registerContentScripts`	88	88	102	?	74	16.4 Доступно для использования в Manifest V2 или выше.	?	?	102	?	16.4 Доступно для использования в Manifest V2 или выше.	?

Примечание: Этот API основан на API chrome.scripting 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/scripting/registerContentScripts