webNavigation.getAllFrames()

details

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

tabId

integer. Идентификатор вкладки.

A Promise, который будет выполнен с массивом объектов, каждый из которых имеет следующие свойства:

errorOccurred

boolean. Истина, если последнее навигационное действие в этом фрейме было прервано ошибкой, т.е. сработал событие onErrorOccurred.

processId

integer. Идентификатор процесса, выполняющего рендерер для этой вкладки.

frameId

integer. Идентификатор фрейма. Если это основной фрейм, то frameId равно нулю.

parentFrameId

integer. Идентификатор родительского фрейма. Равно -1, если родительский фрейм отсутствует: т.е. если этот фрейм является контекстом верхнего уровня просмотра во вкладке.

url

string. URL, в данный момент ассоциированный с этим фреймом.

Если вкладка отброшена, обещание вместо этого выполнится со значением null. Если указанная вкладка не найдена или возникает другая ошибка, обещание будет отклонено с сообщением об ошибке.

Этот код выводит URL всех фреймов в активной вкладке, когда пользователь нажимает на действие браузера:

function logFrameInfo(framesInfo) {
  for (const frameInfo of framesInfo) {
    console.log(frameInfo);
  }
}

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

function logAllFrames(tabs) {
  browser.webNavigation
    .getAllFrames({
      tabId: tabs[0].id,
    })
    .then(logFrameInfo, onError);
}

browser.browserAction.onClicked.addListener(() => {
  browser.tabs
    .query({
      currentWindow: true,
      active: true,
    })
    .then(logAllFrames, onError);
});