devtools.inspectedWindow.eval()

Скрипт получает доступ к ряду объектов, которые помогают инжектированному скрипту взаимодействовать с инструментами разработчика. В настоящее время поддерживаются следующие вспомогательные объекты:

$0

Содержит ссылку на элемент, который в данный момент выбран в инспекторе инструментов разработчика.

inspect()

Если переданный объект является элементом DOM на странице, он выбирает его в инспекторе инструментов разработчика; в противном случае он создаёт предварительный просмотр объекта в веб-консоли.

См. примеры.

expression

string. JavaScript-выражение для оценки. Строка должна быть оценена в объект, который может быть представлен в формате JSON, в противном случае будет выброшено исключение. Например, expression не должно быть оценено в функцию.

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

object. Параметры для функции (обратите внимание, что Firefox пока не поддерживает эти параметры), как указано ниже:

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

string. URL фрейма, в котором нужно оценить выражение. Если это опущено, выражение оценивается в основном фрейме окна.

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

boolean. Если true, оценить выражение в контексте любых скриптов содержимого, которые эта надстройка прикрепила к странице. Если вы установили этот параметр, вы должны были прикрепить какие-либо скрипты содержимого к странице, в противном случае будет выброшена ошибка DevTools.

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

string. Оценить выражение в контексте скрипта содержимого, прикреплённого другой надстройкой, чьё происхождение соответствует указанному значению. Это переопределяет useContentScriptContext.

A Promise, который будет выполнен с array, содержащим два элемента.

Если ошибка не произошла, элемент 0 будет содержать результат оценки выражения, а элемент 1 будет undefined.

Если произошла ошибка, элемент 0 будет undefined, а элемент 1 будет содержать объект, дающий подробности об ошибке. Различаются два типа ошибок:

• ошибки, возникшие при оценке JavaScript (например, синтаксические ошибки в выражении). В этом случае элемент 1 будет содержать:
  • логическое свойство isException, установленное в true
  • строковое свойство value, дающее более подробные сведения.
• другие ошибки (например, выражение, которое оценивается в объект, который не может быть представлен в формате JSON). В этом случае элемент 1 будет содержать:
  • логическое свойство isError, установленное в true
  • строковое свойство code содержащее код ошибки.

Этот пример проверяет, определена ли jQuery в проверяемом окне, и выводит результат. Обратите внимание, что это не сработает в скрипте содержимого, поскольку даже если jQuery будет определена, скрипт содержимого её не увидит.

function handleError(error) {
  if (error.isError) {
    console.log(`Devtools error: ${error.code}`);
  } else {
    console.log(`JavaScript error: ${error.value}`);
  }
}

function handleResult(result) {
  console.log(result);
  if (result[0] !== undefined) {
    console.log(`jQuery: ${result[0]}`);
  } else if (result[1]) {
    handleError(result[1]);
  }
}

const checkjQuery = "typeof jQuery !== 'undefined'";

evalButton.addEventListener("click", () => {
  browser.devtools.inspectedWindow.eval(checkjQuery)
    .then(handleResult);
});

Этот пример использует вспомогательный объект $0 для изменения цвета фона элемента, который в данный момент выбран в инспекторе:

const evalButton = document.querySelector("#reddinate");
const evalString = "$0.style.backgroundColor = 'red'";

function handleError(error) {
  if (error.isError) {
    console.log(`Devtools error: ${error.code}`);
  } else {
    console.log(`JavaScript error: ${error.value}`);
  }
}

function handleResult(result) {
  if (result[1]) {
    handleError(result[1]);
  }
}

evalButton.addEventListener("click", () => {
  browser.devtools.inspectedWindow.eval(evalString)
    .then(handleResult);
});

Этот пример использует вспомогательный объект inspect() для выбора первого элемента <h1> на странице:

const inspectButton = document.querySelector("#inspect");
const inspectString = "inspect(document.querySelector('h1'))";

function handleError(error) {
  if (error.isError) {
    console.log(`Devtools error: ${error.code}`);
  } else {
    console.log(`JavaScript error: ${error.value}`);
  }
}

function handleResult(result) {
  if (result[1]) {
    handleError(result[1]);
  }
}

inspectButton.addEventListener("click", () => {
  browser.devtools.inspectedWindow.eval(inspectString)
    .then(handleResult);
});