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

js
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

BCD tables only load in the browser

Exemples

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

js
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.

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.