Spec-Zone.ru › Web Extensions

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);

Примеры расширений

  • tabs-tabs-tabs

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

Рабочий стол Мобильные устройства
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

Spec-Zone.ru

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