tabs.duplicate()
Дублирует вкладку, заданную её ID.
Это асинхронная функция, которая возвращает Promise.
Синтаксис
let duplicating = browser.tabs.duplicate( tabId, // integer duplicateProperties // optional object )
Параметры
tabId-
integer. ID вкладки, подлежащей дублированию. -
duplicatePropertiesОпционально -
object. Объект, описывающий, как дублируется вкладка. Содержит следующие свойства:-
indexОпционально -
integer. Позиция новой вкладки в окне. Значение ограничено диапазоном от нуля до количества вкладок в окне. -
activeОпционально -
boolean. Становится ли вкладка активной в окне. Не влияет на то, фокусируется ли окно. По умолчаниюtrue.
-
Возвращаемое значение
A Promise, который будет выполнен с объектом tabs.Tab, содержащим сведения о дублированной вкладке. Объект Tab содержит только url, title и favIconUrl, если расширение имеет "tabs" разрешение или соответствующие разрешения на хостинг.
Примечание: Начиная с Firefox 68, promise, возвращаемый browser.tabs.duplicate(), выполняется, как только вкладка была дублирована. Ранее promise выполнялся только после полного загрузки вкладки.
Примеры
Дублирование первой вкладки и вывод ID вновь созданной вкладки:
function onDuplicated(tabInfo) { console.log(tabInfo.id); } function onError(error) { console.log(`Error: ${error}`); } // Duplicate the first tab in the array function duplicateFirstTab(tabs) { console.log(tabs); if (tabs.length > 0) { let duplicating = browser.tabs.duplicate(tabs[0].id); duplicating.then(onDuplicated, onError); } } // Query for all open tabs let querying = browser.tabs.query({}); querying.then(duplicateFirstTab, onError);
Примеры расширений
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
duplicate |
23 | 79 | 47 | ? | 15 | 14 | ? | ? | Нет | ? | 15 | ? |
duplicateProperties |
Нет | Нет | 77 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
tabId |
23 | 79 | 47 | ? | 15 | Да | ? | ? | Нет | ? | Нет | ? |
Примечание: Этот 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/duplicate