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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
duplicateChrome Support complet OuiEdge Aucun support NonFirefox Support complet 47Opera Support complet OuiFirefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
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.