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
ChromeEdgeFirefoxOperaSafariFirefox pour Android
duplicateChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari Support complet 14Firefox Android Aucun support Non
duplicatePropertiesChrome Aucun support NonEdge Aucun support NonFirefox Support complet 77Opera Aucun support NonSafari Aucun support NonFirefox Android Aucun support Non
tabIdChrome Support complet OuiEdge Support complet 79Firefox Support complet 47Opera Support complet OuiSafari 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.