tabs.captureTab()
Создаёт URL данных, кодирующий изображение области указанной вкладки. Для использования этого метода требуется разрешение <all_urls> разрешение.
Это асинхронная функция, которая возвращает Promise.
Синтаксис
let capturing = browser.tabs.captureTab( tabId, // optional integer options // optional extensionTypes.ImageDetails )
Параметры
-
tabIdНеобязательно -
integer. Идентификатор вкладки для захвата. По умолчанию активная вкладка в текущем окне. -
optionsНеобязательно
Возвращаемое значение
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