tabs.duplicate()

Duplique un onglet dont l’identifiant est donné.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var duplicating = browser.tabs.duplicate(
  tabId              // integer
)

Paramètres

tabId
integer. L'identifiant de l'onglet à dupliquer.

valeur retournée

Une Promise qui sera remplie avec un objet tabs.Tab contenant des détails sur l'onglet dupliqué. L'objet onglet contient uniquement url, title et favIconUrl si l'extension a la permission "tabs". Si une erreur se produit, la promesse sera rejetée avec un message d'erreur.

Note: A partir de Firefox 68, la promise retournée par browser.tabs.duplicate() se résout dès que l'onglet a été dupliqué. Auparavant, la promise n'était résolue qu'une fois l'onglet entièrement chargé.

Exemples

Duplique le premier onglet, puis affiche l'ID de l'onglet nouvellement créé :

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) {
    var duplicating = browser.tabs.duplicate(tabs[0].id);
    duplicating.then(onDuplicated, onError);
  }
}

// Query for all open tabs
var querying = browser.tabs.query({});
querying.then(duplicateFirstTab, onError);

Example extensions

Compatibilité du navigateur

BCD tables only load in the browser

Remerciements :

Cette API est basée sur l'API Chromium chrome.tabs. Cette documentation est dérivée de tabs.json dans le code de Chromium code.

Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.