Description
Utilisez l'API chrome.webNavigation
pour recevoir des notifications sur l'état des requêtes de navigation en cours de transfert.
Autorisations
webNavigation
Toutes les méthodes et tous les événements chrome.webNavigation
nécessitent de déclarer l'autorisation "webNavigation"
dans le fichier manifeste de l'extension. Exemple :
{
"name": "My extension",
...
"permissions": [
"webNavigation"
],
...
}
Concepts et utilisation
Ordre des événements
Si la navigation s'est correctement déroulée, les événements sont déclenchés dans l'ordre suivant:
onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted
Toute erreur qui se produit pendant le processus entraîne un événement onErrorOccurred
. Pour une navigation spécifique, aucun autre événement n'est déclenché après onErrorOccurred
.
Si un frame de navigation contient des sous-frames, son onCommitted
est déclenché avant l'onBeforeNavigate
de ses enfants, tandis que onCompleted
est déclenché après tous les onCompleted
de ses enfants.
Si le fragment de référence d'un frame est modifié, un événement onReferenceFragmentUpdated
est déclenché. Cet événement peut se déclencher à tout moment après onDOMContentLoaded
, même après onCompleted
.
Si l'API History est utilisée pour modifier l'état d'un frame (par exemple, à l'aide de history.pushState()
, un événement onHistoryStateUpdated
est déclenché). Cet événement peut se déclencher à tout moment après le onDOMContentLoaded
.
Si une navigation a restauré une page à partir du cache amélioré, l'événement onDOMContentLoaded
ne se déclenche pas. L'événement n'est pas déclenché, car le chargement du contenu est déjà terminé lors de la première visite de la page.
Si une navigation a été déclenchée à l'aide de la fonctionnalité Chrome Instantané ou des Pages instantanées, une page entièrement chargée est basculée dans l'onglet actif. Dans ce cas, un événement onTabReplaced
est déclenché.
Lien avec les événements webRequest
Il n'existe aucun ordre défini entre les événements de l'API webRequest et ceux de l'API webNavigation. Il est possible que les événements webRequest soient toujours reçus pour les frames qui ont déjà démarré une nouvelle navigation, ou qu'une navigation ne se poursuit que lorsque les ressources réseau sont déjà entièrement chargées.
En général, les événements webNavigation sont étroitement liés à l'état de navigation affiché dans l'interface utilisateur, tandis que les événements webRequest correspondent à l'état de la pile réseau, qui est généralement opaque pour l'utilisateur.
ID des onglets
Tous les onglets de navigation ne correspondent pas aux véritables onglets de l'interface utilisateur de Chrome (par exemple, un onglet en cours de préaffichage). Ces onglets ne sont pas accessibles à l'aide de l'API tabs et vous ne pouvez pas demander d'informations à leur sujet en appelant webNavigation.getFrame()
ou webNavigation.getAllFrames()
. Une fois qu'un tel onglet est permuté, un événement onTabReplaced
est déclenché et il devient accessible via ces API.
Codes temporels
Il est important de noter que certaines anomalies techniques dans la gestion des différents processus Chrome par le système d'exploitation peuvent entraîner un décalage de l'horloge entre le navigateur lui-même et les processus d'extension. Cela signifie que la cohérence interne de la propriété timeStamp
de la propriété timeStamp
de l'événement WebNavigation
n'est garantie qu'en interne. En comparant un événement à un autre, vous obtiendrez le décalage correct entre eux, mais le fait de les comparer à l'heure actuelle dans l'extension (en utilisant (new Date()).getTime()
, par exemple) peut donner des résultats inattendus.
ID des frames
Les frames d'un onglet peuvent être identifiés par un ID de frame. L'ID de frame de la trame principale est toujours 0, l'ID des frames enfants est un nombre positif. Une fois qu'un document est construit dans un cadre, son ID de cadre reste constant pendant toute la durée de vie du document. À partir de Chrome 49, cet ID est également constant pendant toute la durée de vie du frame (pour plusieurs navigations).
En raison de la nature multiprocessus de Chrome, un onglet peut utiliser différents processus pour afficher la source et la destination d'une page Web. Par conséquent, si une navigation a lieu dans un nouveau processus, vous pouvez recevoir des événements de la nouvelle et de l'ancienne page jusqu'à ce que la nouvelle navigation soit validée (c'est-à-dire que l'événement onCommitted
est envoyé pour le nouveau frame principal). En d'autres termes, il est possible d'avoir plusieurs séquences d'événements webNavigation en attente avec le même frameId
. Les séquences peuvent être distinguées par la clé processId
.
Notez également qu'au cours d'un chargement provisoire, le processus peut changer plusieurs fois. Cela se produit lorsque la charge est redirigée vers un site différent. Dans ce cas, vous recevrez des événements onBeforeNavigate
et onErrorOccurred
répétés jusqu'à ce que vous receviez l'événement onCommitted
final.
Un autre concept qui pose problème avec les extensions est le cycle de vie du frame. Un frame héberge un document (qui est associé à une URL validée). Le document peut changer (par exemple, en naviguant), mais pas le frameId. Il est donc difficile d'associer ce qui s'est produit dans un document spécifique à seulement frameIds. Nous introduisons un concept de documentId, qui est un identifiant unique par document. Si l'utilisateur navigue dans un cadre et qu'il ouvre un nouveau document, l'identifiant change. Ce champ est utile pour déterminer à quel moment les pages changent d'état de cycle de vie (prérendu/actif/en cache), car il reste le même.
Types et qualificatifs de transition
L'événement onCommitted
webNavigation
possède une propriété transitionType
et une propriété transitionQualifiers
. Le type de transition est le même que celui utilisé dans l'API history, qui décrit la manière dont le navigateur a accédé à cette URL. En outre, plusieurs qualificatifs de transition peuvent être renvoyés pour définir davantage la navigation.
Les qualificatifs de transition suivants existent:
Qualificatif de transition | Description |
---|---|
"client_redirect" | Une ou plusieurs redirections causées par des balises JavaScript ou Meta Refresh sur la page sont survenues pendant la navigation. |
"server_redirect" | Une ou plusieurs redirections causées par des en-têtes HTTP envoyés depuis le serveur se sont produites pendant la navigation. |
"avant_arrière" | L'utilisateur a utilisé le bouton "Suivant" ou "Précédent" pour lancer la navigation. |
"from_address_bar" | L'utilisateur a lancé la navigation à partir de la barre d'adresse (c'est-à-dire de l'omnibox). |
Exemples
Pour essayer cette API, installez l'exemple d'API webNavigation à partir du dépôt chrome-extension-samples.
Types
TransitionQualifier
Enum
"client_redirect"
"server_redirect"
"forward_back"
"from_address_bar"
TransitionType
Cause de la navigation. Les mêmes types de transition que ceux définis dans l'API History sont utilisés. Il s'agit des mêmes types de transition que ceux définis dans l'API history, sauf avec "start_page"
à la place de "auto_toplevel"
(pour des raisons de rétrocompatibilité).
Enum
"link"
"typed"
"auto_bookmark"
"auto_subframe"
"manual_subframe"
"start_page"
"form_submit"
"reload"
"keyword_generated"
Méthodes
getAllFrames()
chrome.webNavigation.getAllFrames(
details: object,
callback?: function,
)
Récupère des informations sur tous les frames d'un onglet donné.
Paramètres
-
détails
objet
Informations sur l'onglet à partir duquel extraire tous les frames.
-
tabId
Nombre
ID de l'onglet.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(details?: object[]) => void
-
détails
objet[] facultatif
Liste des frames dans l'onglet donné, null si l'ID de l'onglet spécifié n'est pas valide.
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
errorOccurred
boolean
"True" si la dernière navigation dans ce frame a été interrompue par une erreur, c'est-à-dire si l'événement onErrorOccurred a été déclenché.
-
frameId
Nombre
Identifiant du cadre. 0 indique qu'il s'agit de la trame principale ; une valeur positive indique l'ID d'un sous-frame.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
ID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
ID du processus qui exécute le moteur de rendu pour cette image.
-
url
chaîne
URL actuellement associée à ce frame.
-
-
Renvoie
-
Promise<object[] | undefined>
Chrome 93 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.
getFrame()
chrome.webNavigation.getFrame(
details: object,
callback?: function,
)
Récupère des informations sur le frame donné. Un cadre désigne un <iframe> ou un <frame> d'une page Web et est identifié par un identifiant de tabulation et un identifiant de frame.
Paramètres
-
détails
objet
Informations sur la trame pour laquelle récupérer des informations.
-
documentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document. Si les valeurs frameId et/ou tabId sont fournies, elles seront validées pour correspondre au document trouvé par l'ID de document fourni.
-
frameId
numéro facultatif
ID du cadre dans l'onglet donné.
-
processId
numéro facultatif
Obsolète depuis Chrome 49Les frames sont désormais identifiés de manière unique par leur ID de tabulation et leur ID de frame. L'ID de processus n'est plus nécessaire et est donc ignoré.
ID du processus qui exécute le moteur de rendu pour cet onglet.
-
tabId
numéro facultatif
ID de l'onglet dans lequel se trouve le cadre.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(details?: object) => void
-
détails
objet facultatif
Informations sur le frame demandé, null si l'ID de frame et/ou l'ID d'onglet spécifié ne sont pas valides.
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
errorOccurred
boolean
"True" si la dernière navigation dans ce frame a été interrompue par une erreur, c'est-à-dire si l'événement onErrorOccurred a été déclenché.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
ID du frame parent, ou
-1
s'il s'agit du frame principal. -
url
chaîne
URL actuellement associée à ce frame, si le frame identifié par le frameId existe à un moment donné dans l'onglet donné. Le fait qu'une URL soit associée à un frameId donné ne signifie pas que le frame correspondant existe toujours.
-
-
Renvoie
-
Promise<object | undefined>
Chrome 93 et versions ultérieuresLes promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.
Événements
onBeforeNavigate
chrome.webNavigation.onBeforeNavigate.addListener(
callback: function,
filters?: object,
)
Déclenché lorsqu'une navigation est sur le point de se produire
Paramètres
-
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
objet
-
Chrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques pour un onglet et un processus donnés.
-
Chrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
Nombre
ID du frame parent, ou
-1
s'il s'agit du frame principal. -
Nombre
Obsolète depuis Chrome 50Le processId n'est plus défini pour cet événement, car le processus qui affichera le document obtenu n'est pas connu avant onCommit.
Valeur de -1.
-
Nombre
ID de l'onglet dans lequel la navigation est sur le point d'avoir lieu.
-
Nombre
Heure à laquelle le navigateur était sur le point de lancer la navigation, en millisecondes depuis l'epoch.
-
chaîne
-
-
-
objet facultatif
-
Les conditions que l'URL consultée doit remplir. Les champs "sch��mas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onCommitted
chrome.webNavigation.onCommitted.addListener(
callback: function,
filters?: object,
)
Déclenché lorsqu'une navigation est validée. Le document (et les ressources auxquelles il fait référence, telles que les images et les sous-cadres) est peut-être toujours en cours de téléchargement, mais au moins une partie du document a été reçue du serveur et le navigateur a décidé de basculer vers le nouveau document.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
frameId
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques au sein d'un onglet.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
Chrome 74 et versions ultérieuresID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
ID du processus qui exécute le moteur de rendu pour cette image.
-
tabId
Nombre
ID de l'onglet dans lequel la navigation a lieu.
-
timeStamp
Nombre
Heure à laquelle la navigation a été validée, en millisecondes depuis l'epoch.
-
transitionQualifiers
Liste de qualificatifs de transition.
-
transitionType
Cause de la navigation.
-
url
chaîne
-
-
-
filtres
objet facultatif
-
url
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onCompleted
chrome.webNavigation.onCompleted.addListener(
callback: function,
filters?: object,
)
Déclenché lorsqu'un document, y compris les ressources auxquelles il fait référence, est entièrement chargé et initialisé.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
frameId
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques au sein d'un onglet.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
Chrome 74 et versions ultérieuresID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
ID du processus qui exécute le moteur de rendu pour cette image.
-
tabId
Nombre
ID de l'onglet dans lequel la navigation a lieu.
-
timeStamp
Nombre
Délai de chargement du document terminé, en millisecondes écoulées depuis l'epoch.
-
url
chaîne
-
-
-
filtres
objet facultatif
-
url
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onCreatedNavigationTarget
chrome.webNavigation.onCreatedNavigationTarget.addListener(
callback: function,
filters?: object,
)
Déclenché lorsqu'une nouvelle fenêtre ou un nouvel onglet dans une fenêtre existante est créé pour héberger une navigation.
Paramètres
-
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
objet
-
Nombre
ID du cadre avec sourceTabId dans lequel la navigation est déclenchée. 0 indique l'image principale.
-
Nombre
ID du processus qui exécute le moteur de rendu pour le frame source.
-
Nombre
ID de l'onglet dans lequel la navigation est déclenchée.
-
Nombre
ID de l'onglet dans lequel l'URL est ouverte
-
Nombre
Heure à laquelle le navigateur était sur le point de créer une vue, en millisecondes depuis l'epoch.
-
chaîne
URL à ouvrir dans une nouvelle fenêtre.
-
-
-
objet facultatif
-
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onDOMContentLoaded
chrome.webNavigation.onDOMContentLoaded.addListener(
callback: function,
filters?: object,
)
Déclenché lorsque le DOM de la page est entièrement construit, mais il est possible que le chargement des ressources référencées ne soit pas terminé.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
frameId
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques au sein d'un onglet.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
Chrome 74 et versions ultérieuresID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
ID du processus qui exécute le moteur de rendu pour cette image.
-
tabId
Nombre
ID de l'onglet dans lequel la navigation a lieu.
-
timeStamp
Nombre
Heure à laquelle le DOM de la page a été entièrement construit, en millisecondes depuis l'epoch.
-
url
chaîne
-
-
-
filtres
objet facultatif
-
url
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onErrorOccurred
chrome.webNavigation.onErrorOccurred.addListener(
callback: function,
filters?: object,
)
Déclenché lorsqu'une erreur se produit et que la navigation est abandonnée Cela peut se produire si une erreur réseau s'est produite ou si l'utilisateur a annulé la navigation.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
error
chaîne
Description de l'erreur.
-
frameId
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques au sein d'un onglet.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
Chrome 74 et versions ultérieuresID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
Obsolète depuis Chrome 50Le processId n'est plus défini pour cet événement.
Valeur de -1.
-
tabId
Nombre
ID de l'onglet dans lequel la navigation a lieu.
-
timeStamp
Nombre
Heure à laquelle l'erreur s'est produite, en millisecondes depuis l'epoch.
-
url
chaîne
-
-
-
filtres
objet facultatif
-
url
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onHistoryStateUpdated
chrome.webNavigation.onHistoryStateUpdated.addListener(
callback: function,
filters?: object,
)
Déclenché lorsque l'historique du frame a été mis à jour vers une nouvelle URL. Tous les événements à venir pour ce frame utiliseront l'URL mise à jour.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
frameId
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques au sein d'un onglet.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
Chrome 74 et versions ultérieuresID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
ID du processus qui exécute le moteur de rendu pour cette image.
-
tabId
Nombre
ID de l'onglet dans lequel la navigation a lieu.
-
timeStamp
Nombre
Heure à laquelle la navigation a été validée, en millisecondes depuis l'epoch.
-
transitionQualifiers
Liste de qualificatifs de transition.
-
transitionType
Cause de la navigation.
-
url
chaîne
-
-
-
filtres
objet facultatif
-
url
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onReferenceFragmentUpdated
chrome.webNavigation.onReferenceFragmentUpdated.addListener(
callback: function,
filters?: object,
)
Déclenché lorsque le fragment de référence d'un frame a été mis à jour. Tous les événements à venir pour ce frame utiliseront l'URL mise à jour.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
documentId
chaîne
Chrome 106 et versions ultérieuresUn UUID du document chargé.
-
documentLifecycleChrome 106 et versions ultérieures
Cycle de vie dans lequel se trouve le document.
-
frameId
Nombre
0 indique que la navigation a lieu dans la fenêtre de contenu de l'onglet ; une valeur positive indique que la navigation dans un sous-frame. Les ID de frame sont uniques au sein d'un onglet.
-
frameTypeChrome 106 et versions ultérieures
Type de frame dans lequel la navigation s'est produite.
-
parentDocumentId
string facultatif
Chrome 106 et versions ultérieuresUUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.
-
parentFrameId
Nombre
Chrome 74 et versions ultérieuresID du frame parent, ou
-1
s'il s'agit du frame principal. -
processId
Nombre
ID du processus qui exécute le moteur de rendu pour cette image.
-
tabId
Nombre
ID de l'onglet dans lequel la navigation a lieu.
-
timeStamp
Nombre
Heure à laquelle la navigation a été validée, en millisecondes depuis l'epoch.
-
transitionQualifiers
Liste de qualificatifs de transition.
-
transitionType
Cause de la navigation.
-
url
chaîne
-
-
-
filtres
objet facultatif
-
url
Les conditions que l'URL consultée doit remplir. Les champs "schémas" et "ports" de UrlFilter sont ignorés pour cet événement.
-
onTabReplaced
chrome.webNavigation.onTabReplaced.addListener(
callback: function,
)
Déclenché lorsque le contenu de l'onglet est remplacé par un autre onglet (généralement préaffiché).
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(details: object) => void
-
détails
objet
-
replacedTabId
Nombre
ID de l'onglet qui a été remplacé.
-
tabId
Nombre
ID de l'onglet qui a remplacé l'ancien.
-
timeStamp
Nombre
Heure à laquelle le remplacement s'est produit, en millisecondes depuis l'epoch.
-
-