Spec-Zone.ru › Web Extensions

tabs.captureTab()

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

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

Синтаксис

let capturing = browser.tabs.captureTab(
  tabId,               // optional integer
  options              // optional extensionTypes.ImageDetails
)

Параметры

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

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.captureTab();
  capturing.then(onCaptured, onError);
});

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

Рабочие столы Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet
captureTab Нет Нет 59 ? Нет Нет ? ? 82 ? Нет ?

Примечание: Этот 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/captureTab

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API