chrome.webNavigation

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 transitionDescription
"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

Chrome 44 ou version ultérieure

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 ou version ultérieure

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()

Promesse 
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

      number

      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érieures

        Un UUID du document chargé.

      • documentLifecycle

        DocumentLifecycle

        Chrome 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

        number

        Identifiant du cadre. 0 indique qu'il s'agit de la trame principale ; une valeur positive indique l'ID d'un sous-frame.

      • frameType

        FrameType

        Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        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érieures

    Les 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()

Promesse 
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érieures

      UUID 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 49

      Les 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érieures

        Un UUID du document chargé.

      • documentLifecycle

        DocumentLifecycle

        Chrome 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é.

      • frameType

        FrameType

        Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        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érieures

    Les 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

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    (details: object)=>void

    • détails

      objet

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • frameId

        number

        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.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        Obsolète depuis Chrome 50

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

      • tabId

        number

        ID de l'onglet dans lequel la navigation est sur le point d'avoir lieu.

      • timeStamp

        number

        Heure à laquelle le navigateur était sur le point de lancer la navigation, en millisecondes depuis l'epoch.

      • url

        chaîne

  • filtres

    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érieures

        Un UUID du document chargé.

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • frameId

        number

        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.

      • Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        Chrome 74 et versions ultérieures

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        ID du processus qui exécute le moteur de rendu pour cette image.

      • tabId

        number

        ID de l'onglet dans lequel la navigation a lieu.

      • timeStamp

        number

        Heure à laquelle la navigation a été validée, en millisecondes depuis l'epoch.

      • transitionQualifiers

        TransitionQualifier[]

        Liste de qualificatifs de transition.

      • transitionType

        TransitionType

        Cause de la navigation.

      • url

        chaîne

  • filtres

    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.

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érieures

        Un UUID du document chargé.

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • frameId

        number

        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.

      • Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        Chrome 74 et versions ultérieures

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        ID du processus qui exécute le moteur de rendu pour cette image.

      • tabId

        number

        ID de l'onglet dans lequel la navigation a lieu.

      • timeStamp

        number

        Délai de chargement du document terminé, en millisecondes écoulées depuis l'epoch.

      • url

        chaîne

  • filtres

    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.

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

  • rappel

    function

    Le paramètre callback se présente comme suit : 

    (details: object)=>void

    • détails

      objet

      • sourceFrameId

        number

        ID du cadre avec sourceTabId dans lequel la navigation est déclenchée. 0 indique l'image principale.

      • sourceProcessId

        number

        ID du processus qui exécute le moteur de rendu pour le frame source.

      • sourceTabId

        number

        ID de l'onglet dans lequel la navigation est déclenchée.

      • tabId

        number

        ID de l'onglet dans lequel l'URL est ouverte

      • timeStamp

        number

        Heure à laquelle le navigateur était sur le point de créer une vue, en millisecondes depuis l'epoch.

      • url

        chaîne

        URL à ouvrir dans une nouvelle fenêtre.

  • filtres

    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érieures

        Un UUID du document chargé.

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • frameId

        number

        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.

      • Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        Chrome 74 et versions ultérieures

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        ID du processus qui exécute le moteur de rendu pour cette image.

      • tabId

        number

        ID de l'onglet dans lequel la navigation a lieu.

      • timeStamp

        number

        Heure à laquelle le DOM de la page a été entièrement construit, en millisecondes depuis l'epoch.

      • url

        chaîne

  • filtres

    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.

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érieures

        Un UUID du document chargé.

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • error

        chaîne

        Description de l'erreur.

      • frameId

        number

        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.

      • Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        Chrome 74 et versions ultérieures

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        Obsolète depuis Chrome 50

        Le processId n'est plus défini pour cet événement.

        Valeur de -1.

      • tabId

        number

        ID de l'onglet dans lequel la navigation a lieu.

      • timeStamp

        number

        Heure à laquelle l'erreur s'est produite, en millisecondes depuis l'epoch.

      • url

        chaîne

  • filtres

    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.

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érieures

        Un UUID du document chargé.

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • frameId

        number

        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.

      • Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        Chrome 74 et versions ultérieures

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        ID du processus qui exécute le moteur de rendu pour cette image.

      • tabId

        number

        ID de l'onglet dans lequel la navigation a lieu.

      • timeStamp

        number

        Heure à laquelle la navigation a été validée, en millisecondes depuis l'epoch.

      • transitionQualifiers

        TransitionQualifier[]

        Liste de qualificatifs de transition.

      • transitionType

        TransitionType

        Cause de la navigation.

      • url

        chaîne

  • filtres

    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.

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érieures

        Un UUID du document chargé.

      • Chrome 106 et versions ultérieures

        Cycle de vie dans lequel se trouve le document.

      • frameId

        number

        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.

      • Chrome 106 et versions ultérieures

        Type de frame dans lequel la navigation s'est produite.

      • parentDocumentId

        string facultatif

        Chrome 106 et versions ultérieures

        UUID du document parent propriétaire de ce frame. Cette valeur n'est pas définie s'il n'y a pas de parent.

      • parentFrameId

        number

        Chrome 74 et versions ultérieures

        ID du frame parent, ou -1 s'il s'agit du frame principal.

      • processId

        number

        ID du processus qui exécute le moteur de rendu pour cette image.

      • tabId

        number

        ID de l'onglet dans lequel la navigation a lieu.

      • timeStamp

        number

        Heure à laquelle la navigation a été validée, en millisecondes depuis l'epoch.

      • transitionQualifiers

        TransitionQualifier[]

        Liste de qualificatifs de transition.

      • transitionType

        TransitionType

        Cause de la navigation.

      • url

        chaîne

  • filtres

    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.

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

        number

        ID de l'onglet qui a été remplacé.

      • tabId

        number

        ID de l'onglet qui a remplacé l'ancien.

      • timeStamp

        number

        Heure à laquelle le remplacement s'est produit, en millisecondes depuis l'epoch.