scripting.getRegisteredContentScripts()

Возвращает все зарегистрированные скрипты контента с помощью scripting.registerContentScripts(), или подмножество зарегистрированных скриптов при использовании фильтра.

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

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

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

Синтаксис

let scripts = await browser.scripting.getRegisteredContentScripts(
  filter          // object
)

Параметры

filter Необязательно: scripting.ContentScriptFilter. Фильтр для возвращаемых подробностей о зарегистрированном скрипте.

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

A Promise, которая выполняется с массивом scripting.RegisteredContentScript. При возникновении ошибки промис отклоняется.

Примеры

В этом примере возвращаются все зарегистрированные скрипты контента:

// Register two content scripts.
await browser.scripting.registerContentScripts([
  {
    id: "script-1",
    js: ["script-1.js"],
    matches: ["*://example.com/*"],
  },
  {
    id: "script-2",
    js: ["script-2.js"],
    matches: ["*://example.com/*"],
  },
]);

// Retrieve all content scripts.
let scripts = await browser.scripting.getRegisteredContentScripts();
console.log(scripts.map((script) => script.id)); // ["script-1", "script-2"]

// Only retrieve the second script.
scripts = await browser.scripting.getRegisteredContentScripts({
  ids: ["script-2"],
});
console.log(scripts.map((script) => script.id)); // ["script-2"]

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

	Рабочий стол						Мобильный
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet
`getRegisteredContentScripts`	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/getRegisteredContentScripts