tabs.onMoved

Lancé lorsqu'un onglet est déplacé dans une fenêtre

Un seul événement de déplacement est déclenché, représentant l'onglet que l'utilisateur a déplacé directement. Les événements de déplacement ne sont pas déclenchés pour les autres onglets qui doivent se déplacer en réponse. Cet événement n'est pas déclenché lorsqu'un onglet est déplacé entre des fenêtres. Pour cela, voir tabs.onDetached.

Syntaxe

browser.tabs.onMoved.addListener(listener);
browser.tabs.onMoved.removeListener(listener);
browser.tabs.onMoved.hasListener(listener);

Les événements ont trois fonctions:

addListener(callback): Ajoute un écouteur à cet événement.
removeListener(listener): Arrêtez d'écouter cet événement. L'argument listener st l'écouteur à supprimer.
hasListener(listener): Vérifiez si le listener est enregistré pour cet événement. Renvoie true s'il écoute, sinon false.

Syntaxe addListener

Paramètres

callback

Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :

tabId: integer. ID de l'onglet déplacé par l'utilisateur.

moveInfo: object. Informations sur le déménagement.

Objets supplémentaires

moveInfo

windowId: integer. ID de la fenêtre de cet onglet.
fromIndex: integer. Index initial de cet onglet dans la fenêtre.
toIndex: integer. Index final de cet onglet dans la fenêtre

Exemples

Écouter et enregistrer les événements de déplacement :

function handleMoved(tabId, moveInfo) {
  console.log(
    "Tab " +
      tabId +
      " moved from " +
      moveInfo.fromIndex +
      " to " +
      moveInfo.toIndex,
  );
}

browser.tabs.onMoved.addListener(handleMoved);

Exemples d'extensions

tabs-tabs-tabs

Compatibilité des navigateurs

Note :

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.

Help improve MDN

Learn how to contribute

Cette page a été modifiée le ⁨7 sept. 2025⁩ par les contributeurs du MDN.

View this page on GitHub • Report a problem with this content