scripting.updateContentScripts()

Обновляет зарегистрированные скрипты контента. Если при разборе скриптов и проверке файлов возникнут ошибки или указанные идентификаторы не существуют, скрипты не обновляются.

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

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

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

Синтаксис

await browser.scripting.updateContentScripts(
  scripts         // object
)

Параметры

scripts: array из scripting.RegisteredContentScript. Подробности скрипта для обновления. Все свойства являются необязательными, за исключением id.

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

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

Примеры

В этом примере обновляется скрипт контента, зарегистрированный с идентификатором a-script, устанавливая allFrames в значение true:

try {
  await browser.scripting.registerContentScripts([
    {
      id: "a-script",
      js: ["script.js"],
      matches: ["*://example.org/*"],
    },
  ]);

  // Update content script registered before to allow execution
  // in all frames:
  await browser.scripting.updateContentScripts([
    {
      id: "a-script",
      allFrames: true,
    },
  ]);
} catch (err) {
  console.error(`failed to register or update content scripts: ${err}`);
}

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

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

Примечание: Этот 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/updateContentScripts