history.onTitleChanged

Lancé lorsque le titre d'une page visitée par l'utilisateur est enregistré.Pour écouter les visites d'une page, vous pouvez utiliser history.onVisited. Cependant, le history.HistoryItem que cet événement passe à son écouteur n'inclut pas le titre de la page, car le titre de la page n'est généralement pas connu au moment où history.onVisited est envoyé.Au lieu de cela, history.HistoryItem stocké est mis à jour avec le titre de la page après le chargement de la page, une fois le titre connu. L'événement history.onTitleChanged est déclenché à ce moment-là. Donc, si vous avez besoin de connaître les titres des pages telles qu'elles sont visitées, écoutez history.onTitleChanged.

Syntaxe

browser.history.onTitleChanged.addListener(listener);
browser.history.onTitleChanged.removeListener(listener);
browser.history.onTitleChanged.hasListener(listener);

Les événements ont trois fonctions :

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

Syntaxe addListener

Paramètres

callback

Function that will be called when this event occurs. The function will be passed an object with the following properties:

url: String. URL of the page visited.
title: String. Title of the page visited.

Compatibilité des navigateurs

Exemples

Écoutez les événements de changement de titre et consignez l'URL et le titre des pages visitées

function handleTitleChanged(item) {
  console.log(item.title);
  console.log(item.url);
}

browser.history.onTitleChanged.addListener(handleTitleChanged);

Note :

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

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