tabs.executeScript()

tabId Необязательно

integer. Идентификатор вкладки, в которой необходимо запустить скрипт.

По умолчанию активная вкладка текущего окна.

details

Объект, описывающий скрипт для выполнения.

Он содержит следующие свойства:

allFrames Необязательно

boolean. Если true, код будет вставлен во все фреймы текущей страницы.

Если true и frameId установлены, это вызовет ошибку. (frameId и allFrames взаимоисключающие.)

Если false, код вставляется только в верхний фрейм.

По умолчанию false.

code Необязательно

string. Код для вставки, как строка текста.

Предупреждение: Не используйте это свойство для интерполяции недоверенных данных в JavaScript, так как это может привести к проблеме безопасности.

file Необязательно

string. Путь к файлу, содержащему код для вставки.

• В Firefox относительные URL, не начинающиеся с корня расширения, разрешаются относительно текущего URL страницы.
• В Chrome эти URL разрешаются относительно базового URL расширения.

Для кроссбраузерной совместимости вы можете указать путь как относительный URL, начинающийся с корня расширения, например: "/path/to/script.js".

frameId Необязательно

integer. Фрейм, в который необходимо вставить код.

По умолчанию 0 (фрейм верхнего уровня).

matchAboutBlank Необязательно

boolean. Если true, код будет вставлен в вложенные about:blank и about:srcdoc фреймы, если ваше расширение имеет доступ к их родительскому документу. Код не может быть вставлен в верхнеуровневые about: фреймы.

По умолчанию false.

runAt Необязательно

extensionTypes.RunAt. Самый ранний момент, когда код будет вставлен во вкладку.

По умолчанию "document_idle".

A Promise, который будет разрешен в массив объектов. Элементы массива представляют результат выполнения скрипта в каждом вставленном фрейме.

Результат выполнения скрипта — это последнее вычисленное выражение, что аналогично тому, что выводилось бы (результаты, а не любые console.log() выводы), если бы вы выполнили скрипт в Консоли разработчика. Например, рассмотрим такой скрипт:

let foo='my result'; foo;

В этом случае массив результатов будет содержать строку "my result" в качестве элемента.

Значения результатов должны быть структурируемо клонируемыми (см. алгоритм клонирования данных).

Если произойдёт ошибка, промис будет отклонен с сообщением об ошибке.

В этом примере выполняется однострочный фрагмент кода в текущей активной вкладке:

function onExecuted(result) {
  console.log(`We made it green`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

const makeItGreen = 'document.body.style.border = "5px solid green"';

const executing = browser.tabs.executeScript({
  code: makeItGreen
});
executing.then(onExecuted, onError);

В этом примере выполняется скрипт из файла (упакованного с расширением) под названием "content-script.js". Скрипт выполняется в текущей активной вкладке. Скрипт выполняется и в подфреймах, и в основном документе:

function onExecuted(result) {
  console.log(`We executed in all subframes`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

const executing = browser.tabs.executeScript({
  file: "/content-script.js",
  allFrames: true
});
executing.then(onExecuted, onError);

В этом примере выполняется скрипт из файла (упакованного с расширением) под названием "content-script.js". Скрипт выполняется во вкладке с идентификатором 2:

function onExecuted(result) {
  console.log(`We executed in tab 2`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

const executing = browser.tabs.executeScript(
  2, {
    file: "/content-script.js"
});
executing.then(onExecuted, onError);

• beastify
• context-menu-copy-link-with-types
• devtools-panels
• imagify
• menu-demo
• menu-remove-element