webNavigation.onCommitted
Lancé lorsqu'une navigation est validée. Au moins une partie du nouveau document a été reçue du serveur et le navigateur a décidé de passer au nouveau document.
Syntaxe
browser.webNavigation.onCommitted.addListener(
listener, // function
filter, // optional object
);
browser.webNavigation.onCommitted.removeListener(listener);
browser.webNavigation.onCommitted.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
est l'écouteur à supprimer. hasListener(listener)
-
Vérifiez si
listener
est enregistré pour cet événement. Renvoietrue
s'il est écouté, sinonfalse
.
Syntaxe addListener
Paramètres
callback
-
Fonction qui sera appelée lorsque cet événement se produit. La fonction recevra les arguments suivants :
filter
Facultatif-
object
. Un objet contenant une seule propriété url, qui est untableau
d'objetsevents.UrlFilter
. Si vous incluez ce paramètre, l'événement se déclenchera uniquement pour les transitions vers les URL qui correspondent à au moins unUrlFilter
dans le tableau. Si vous omettez ce paramètre, l'événement se déclenchera pour toutes les transitions.
Objets supplémentaires
Détails
tabId
-
integer
. L'ID de l'onglet dans lequel la navigation est sur le point de se produire. url
-
string
. L'URL à laquelle le cadre donné va naviguer. processId
-
integer
. L'ID du processus dans lequel cet onglet est rendu. frameId
-
integer
. Frame dans lequel la navigation aura lieu. 0 indique que la navigation se déroule dans le contexte de navigation de niveau supérieur de l'onglet, et non dans un iframe imbriqué. A positive value indicates that navigation happens in a nested iframe. Les ID de frame sont uniques pour un onglet et un processus donnés. parentFrameId
-
integer
. ID du parent de cette image. Réglez à -1 s'il s'agit d'un cadre de niveau supérieur. timeStamp
-
number
. L'heure à laquelle la navigation a été validée, en millisecondes depuis l'époque. transitionType
-
. La raison de la navigation : par exemple,transitionType
"link"
si l'utilisateur a cliqué sur un lien, ou"reload"
si l'utilisateur a rechargé la page. transitionQualifiers
-
Array
de
. Informations supplémentaires sur la navigation : par exemple, s'il existait une redirection de serveur ou de client.transitionQualifier
Compatibilité des navigateurs
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
onCommitted | |||||||
transitionQualifiers | |||||||
transitionType |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.
Exemples
Logs les URL cibles et les informations de transition supplémentaires pour onCommitted
, si le nom d'hôte de l'URL cible contient "example.com" ou commence avec "developer".
var filter = {
url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }],
};
function logOnCommitted(details) {
console.log("target URL: " + details.url);
console.log("transition type: " + details.transitionType);
console.log("transition qualifiers: " + details.transitionQualifiers);
}
browser.webNavigation.onCommitted.addListener(logOnCommitted, filter);
Example extensions
Note :
Cette API est basée sur l'API Chromium chrome.webNavigation
. Cette documentation est dérivée de web_navigation.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.