tabs.captureVisibleTab()

Создаёт URL данных, кодирующий изображение активной вкладки в указанном окне. Для использования этого метода необходимо разрешение <all_urls> разрешение. (В качестве альтернативы, Chrome позволяет использовать этот метод с разрешением activeTab разрешением и соответствующим действием пользователя).

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

Синтаксис

let capturing = browser.tabs.captureVisibleTab(
  windowId,               // optional integer
  options                 // optional extensionTypes.ImageDetails
)

Параметры

windowId Необязательно: integer. Целевое окно. По умолчанию — текущее окно.
options Необязательно: extensionTypes.ImageDetails.

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

A Promise, который будет выполнен с URL данных, кодирующим захваченное изображение. Может быть назначен свойству 'src' элемента HTML Image для отображения. Если произойдёт ошибка, промис будет отклонен с сообщением об ошибке.

Примеры

Захват изображения активной вкладки в текущем окне с настройками по умолчанию:

function onCaptured(imageUri) {
  console.log(imageUri);
}

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

browser.browserAction.onClicked.addListener(() => {
  let capturing = browser.tabs.captureVisibleTab();
  capturing.then(onCaptured, onError);
});

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

	Рабочие столы						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`captureVisibleTab`	5 По умолчанию формат файла — 'jpeg'.	15	47	?	15 По умолчанию формат файла — 'jpeg'.	14 ["По умолчанию формат файла — 'jpeg'.", "`<all_urls>` разрешение является необязательным."]	?	?	54	?	15 ["По умолчанию формат файла — 'jpeg'.", "`<all_urls>` разрешение является необязательным."]	?

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