webNavigation.getFrame()

Получает информацию о конкретной вкладке. Вкладка может быть главной вьюшкой в закладке или вложенной <iframe> и уникально идентифицируется ID вкладки и ID вьюшки.

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

Синтаксис

let gettingFrame = browser.webNavigation.getFrame(
  details                // object
)

Параметры

details

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

tabId: integer. ID вкладки, в которой находится вьюшка.
processId Необязательно: integer. ID процесса, который выполняет рендерер для данной вкладки.
frameId: integer. ID вьюшки в данной вкладке.

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

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

errorOccurred: boolean. True, если последнее перенаправление в этой вкладке было прервано ошибкой, т. е. сработало событие onErrorOccurred.
url: string. URL, текущий для этой вьюшки, если вьюшка, идентифицированная frameId, существовала в какой-то момент во вкладке, идентифицированной tabId. Факт того, что URL связан с данной frameId, не подразумевает, что соответствующая вьюшка по-прежнему существует.
parentFrameId: integer. ID родительской вьюшки. -1, если родительской вьюшки нет: то есть, если эта вьюшка является основным контекстом просмотра в закладке.

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

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

	Рабочий стол						Мобильные
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet
`getFrame`	Да	14	47	?	17	14	?	?	48	?	15	?

Примеры

function onGot(frameInfo) {
  console.log(frameInfo);
}

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

let gettingFrame = browser.webNavigation.getFrame({
  tabId: 19,
  frameId: 1537
});

// Edge specific - processId is required not optional, must be integer not null
//let gettingFrame = browser.webNavigation.getFrame({ tabId: 19, processId: 0, frameId: 1537 });

gettingFrame.then(onGot, onError);

Примечание: Этот API основан на API chrome.webNavigation Chromium. Данная документация взята из web_navigation.json кода 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/webNavigation/getFrame