chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.webNavigation API om meldingen te krijgen over de status van navigatieverzoeken tijdens de vlucht.

Rechten

webNavigation

Dit recht activeert een waarschuwing.

Manifest

Voor alle chrome.webNavigation-methoden en -gebeurtenissen moet je het recht webNavigation definiëren in het extensiemanifest. Voorbeeld:

{
  "name": "My extension",
  ...
  "permissions": [
    "webNavigation"
  ],
  ...
}

Volgorde van gebeurtenissen

Voor een navigatie die is afgerond, worden gebeurtenissen in deze volgorde geactiveerd:

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

Elke fout die tijdens het proces optreedt, leidt tot een onErrorOccurred-gebeurtenis. Voor een specifieke navigatie worden er geen verdere gebeurtenissen geactiveerd na onErrorOccurred.

Als een navigatieframe subframes bevat, wordt de onCommitted geactiveerd vóór de onderliggende frames. onBeforeNavigate De onCompleted wordt geactiveerd na alle onderliggende onCompleted.

Als het referentiefragment van een frame wordt gewijzigd, wordt een onReferenceFragmentUpdated-gebeurtenis geactiveerd. Deze gebeurtenis kan op elk moment na onDOMContentLoaded worden geactiveerd, zelfs na onCompleted.

Als de geschiedenis-API wordt gebruikt om de status van een frame aan te passen (bijvoorbeeld met history.pushState()), wordt een onHistoryStateUpdated-gebeurtenis geactiveerd. Deze gebeurtenis kan op elk moment na onDOMContentLoaded worden geactiveerd.

Als een navigatie een pagina heeft hersteld vanuit de Back-Forward Cache, wordt de gebeurtenis onDOMContentLoaded niet geactiveerd. De gebeurtenis wordt niet geactiveerd omdat de content al is geladen wanneer de pagina voor het eerst wordt bezocht.

Als een navigatie is geactiveerd via Chrome Instant of Instant Pages, wordt een volledig geladen pagina verwisseld met het huidige tabblad. In dat geval wordt een onTabReplaced-gebeurtenis geactiveerd.

Relatie met webRequest-gebeurtenissen

Er is geen gedefinieerde volgorde tussen gebeurtenissen van de webRequest API en de gebeurtenissen van de webNavigation API. Het is mogelijk dat webRequest-gebeurtenissen nog steeds worden ontvangen voor frames die al een nieuwe navigatie hebben gestart of dat een navigatie pas doorgaat nadat de netwerkbronnen al volledig zijn geladen.

Over het algemeen zijn de webNavigation-gebeurtenissen nauw gerelateerd aan de navigatiestatus die wordt weergegeven in de UI, terwijl de webRequest-gebeurtenissen overeenkomen met de status van de netwerkstack, die over het algemeen ondoorzichtig is voor de gebruiker.

Tabblad-ID's

Niet alle navigatietabbladen komen overeen met echte tabbladen in de UI van Chrome, bijvoorbeeld een tabblad dat vooraf wordt gerenderd. Dergelijke tabbladen zijn niet toegankelijk via de tabs API en je kunt er geen informatie over opvragen via webNavigation.getFrame of webNavigation.getAllFrames. Zodra zo'n tabblad wordt gewisseld, wordt een onTabReplaced-gebeurtenis geactiveerd en worden ze toegankelijk via deze API's.

Tijdstempels

Het is belangrijk om te weten dat sommige technische eigenaardigheden in de manier waarop het OS verschillende Chrome-processen verwerkt, ertoe kunnen leiden dat de klok scheef loopt tussen de browser zelf en extensieprocessen. Dat betekent dat de property timeStamp van de gebeurtenissen van WebNavigation alleen gegarandeerd intern consistent is. Als je de ene gebeurtenis met de andere vergelijkt, krijg je de juiste offset tussen de gebeurtenissen, maar als je ze vergelijkt met de huidige tijd in de extensie (bijvoorbeeld via (new Date()).getTime()), kan dit onverwachte resultaten opleveren.

Frame-ID's

Frames binnen een tabblad kunnen worden geïdentificeerd aan de hand van een frame-ID. De frame-ID van het hoofdframe is altijd 0, de ID van onderliggende frames is een positief getal. Nadat een document in een frame is gemaakt, blijft de frame-ID constant gedurende de levensduur van het document. Vanaf Chrome 49 is deze ID ook constant gedurende de levensduur van het frame (voor meerdere navigaties).

Vanwege de aard van Chrome met meerdere processen kan een tabblad verschillende processen gebruiken om de bron en bestemming van een webpagina weer te geven. Als een navigatie plaatsvindt in een nieuw proces, kun je dus gebeurtenissen krijgen van zowel de nieuwe als de oude pagina totdat de nieuwe navigatie is vastgelegd (dat wil zeggen dat de gebeurtenis onCommitted wordt gestuurd voor het nieuwe hoofdframe). Met andere woorden, het is mogelijk om meer dan één openstaande reeks webNavigation-gebeurtenissen met dezelfde frameId te hebben. De reeksen kunnen worden onderscheiden door de sleutel processId.

Houd er ook rekening mee dat het proces tijdens een voorlopige lading meerdere keren kan worden gewijzigd. Dit gebeurt als de belasting wordt omgeleid naar een andere site. In dit geval krijg je herhaalde onBeforeNavigate- en onErrorOccurred-gebeurtenissen totdat je de laatste onCommitted-gebeurtenis krijgt.

Een ander concept dat problematisch is met extensies, is de levenscyclus van het frame. Een frame host een document (dat is gekoppeld aan een vastgelegde URL). Het document kan veranderen (bijvoorbeeld door te navigeren), maar de frameId niet. Daarom is het moeilijk om te koppelen dat er iets is gebeurd in een specifiek document met alleen frameIds. We introduceren het concept van een documentId, een unieke ID per document. Als een frame wordt genavigeerd en een nieuw document opent, verandert de ID. Dit veld is handig om te bepalen wanneer pagina's hun levenscyclusstatus wijzigen (tussen prerenderen/actief/gecached), omdat deze hetzelfde blijft.

Overgangstypen en kwalificaties

De gebeurtenis onCommitted van de webNavigation API heeft een property transitionType en transitionQualifiers. Het overgangstype is hetzelfde als het type dat wordt gebruikt in de geschiedenis-API die beschrijft hoe de browser naar deze specifieke URL is genavigeerd. Daarnaast kunnen er verschillende overgangskwalificaties worden geretourneerd die de navigatie verder definiëren.

De volgende overgangskwalificaties zijn van toepassing:

Kwalificatie overgang	Beschrijving
"client_redirect"	Er zijn tijdens de navigatie een of meer omleidingen uitgevoerd die zijn veroorzaakt door JavaScript- of meta-refresh-tags op de pagina.
"server_redirect"	Tijdens de navigatie zijn een of meer omleidingen uitgevoerd die zijn veroorzaakt door HTTP-headers die vanaf de server zijn gestuurd.
"forward_back"	De gebruiker heeft de knop Vooruit of de terugknop gebruikt om de navigatie te starten.
"from_address_bar"	De gebruiker heeft de navigatie gestart vanuit de adresbalk (ook wel omnibox genoemd).

Voorbeelden

Als je deze API wilt proberen, installeer je het voorbeeld van de webNavigation API uit de repository chrome-extension-samples.

Typen

TransitionQualifier

Chrome 44+

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44+

Oorzaak van de navigatie. Dezelfde overgangstypen als gedefinieerd in de geschiedenis-API worden gebruikt. Dit zijn dezelfde overgangstypen als gedefinieerd in de history API, behalve dat "start_page" wordt gebruikt in plaats van "auto_toplevel" (voor compatibiliteit met eerdere versies).

Enum

"link"

"typed"

"auto_bookmark"

auto_subframe

"manual_subframe"

"generated"

"start_page"

form_submit

"reload"

"keyword"

"keyword_generated"

Methoden

getAllFrames()

Promise

chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
): Promise<object[] | undefined>

Hiermee wordt informatie over alle frames van een bepaald tabblad opgehaald.

Parameters

• details

  object

  Informatie over het tabblad waaruit alle frames moeten worden opgehaald.

  • tabId

    getal

    De ID van het tabblad.

• callback

  functie optioneel

  De parameter callback ziet er zo uit:

  (details?: object[]) => void

  • details

    object[] optioneel

    Een lijst met frames op het aangegeven tabblad, null als de aangegeven tabblad-ID ongeldig is.

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • errorOccurred

      booleaans

      Waar als de laatste navigatie in dit frame is onderbroken door een fout, d.w.z. de gebeurtenis onErrorOccurred is geactiveerd.

    • frameId

      getal

      De ID van het frame. 0 geeft aan dat dit het hoofdframe is. Een positieve waarde geeft de ID van een subframe aan.

    • frameType

      FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      De ID van het proces dat de renderer voor dit frame uitvoert.

    • url

      tekenreeks

      De URL die op dit moment aan dit frame is gekoppeld.

Retourzendingen

• Promise<object[] | undefined>

  Chrome 93+

  Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getFrame()

Promise

chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
): Promise<object | undefined>

Hiermee wordt informatie over het aangegeven frame opgehaald. Een frame verwijst naar een <iframe> of een <frame> van een webpagina en wordt geïdentificeerd door een tabblad-ID en een frame-ID.

Parameters

• details

  object

  Informatie over het frame waarover je informatie wilt ophalen.

  • documentId

    tekenreeks optioneel

    Chrome 106+

    De UUID van het document. Als de frameId en/of tabId worden verstrekt, worden ze gevalideerd om overeen te komen met het document dat is gevonden met de verstrekte document-ID.

  • frameId

    number optioneel

    De ID van het frame op het aangegeven tabblad.

  • processId

    number optioneel

    Beëindigd sinds Chrome 49

    Frames worden nu uniek geïdentificeerd door hun tabblad-ID en frame-ID. De proces-ID is niet meer nodig en wordt daarom genegeerd.

    De ID van het proces dat de renderer voor dit tabblad uitvoert.

  • tabId

    number optioneel

    De ID van het tabblad waarin het frame zich bevindt.

• callback

  functie optioneel

  De parameter callback ziet er zo uit:

  (details?: object) => void

  • details

    object optioneel

    Informatie over het aangevraagde frame, null als de opgegeven frame-ID en/of tabblad-ID ongeldig zijn.

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • errorOccurred

      booleaans

      Waar als de laatste navigatie in dit frame is onderbroken door een fout, d.w.z. de gebeurtenis onErrorOccurred is geactiveerd.

    • frameType

      FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • url

      tekenreeks

      De URL die op dit moment aan dit frame is gekoppeld, als het frame dat wordt geïdentificeerd door de frameId op een bepaald moment in het aangegeven tabblad bestond. Het feit dat een URL is gekoppeld aan een bepaalde frameId, betekent niet dat het bijbehorende frame nog bestaat.

Retourzendingen

• Promise<object | undefined>

  Chrome 93+

  Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als er een navigatie gaat plaatsvinden.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek voor een bepaald tabblad en proces.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      Beëindigd sinds Chrome 50

      De processId is niet meer ingesteld voor deze gebeurtenis, omdat het proces dat het resulterende document weergeeft pas bekend is bij onCommit.

      De waarde van -1.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie gaat plaatsvinden.

    • timeStamp

      getal

      De tijd waarop de browser op het punt stond de navigatie te starten, in milliseconden sinds het tijdperk.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als een navigatie wordt vastgelegd. Het document (en de bronnen waarnaar het verwijst, zoals afbeeldingen en subframes) wordt misschien nog gedownload, maar ten minste een deel van het document is ontvangen van de server en de browser heeft besloten over te schakelen naar het nieuwe document.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      Chrome 74+

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      De ID van het proces dat de renderer voor dit frame uitvoert.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie plaatsvindt.

    • timeStamp

      getal

      De tijd waarop de navigatie is vastgelegd, in milliseconden sinds het tijdperk.

    • transitionQualifiers

      TransitionQualifier[]

      Een lijst met overgangskwalificaties.

    • transitionType

      TransitionType

      Oorzaak van de navigatie.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als een document, inclusief de bronnen waarnaar het verwijst, volledig is geladen en geïnitialiseerd.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      Chrome 74+

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      De ID van het proces dat de renderer voor dit frame uitvoert.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie plaatsvindt.

    • timeStamp

      getal

      De tijd waarop het document is geladen, in milliseconden sinds het tijdperk.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als er een nieuw venster of een nieuw tabblad in een bestaand venster wordt gemaakt om een navigatie te hosten.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • sourceFrameId

      getal

      De ID van het frame met sourceTabId waarin de navigatie wordt geactiveerd. 0 geeft het hoofdframe aan.

    • sourceProcessId

      getal

      De ID van het proces dat het weergaveprogramma voor het bronframe uitvoert.

    • sourceTabId

      getal

      De ID van het tabblad waarin de navigatie is geactiveerd.

    • tabId

      getal

      De ID van het tabblad waarin de URL wordt geopend

    • timeStamp

      getal

      De tijd waarop de browser op het punt stond een nieuwe weergave te maken, in milliseconden sinds het tijdperk.

    • url

      tekenreeks

      De URL die in het nieuwe venster moet worden geopend.

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als de DOM van de pagina volledig is samengesteld, maar de bronnen waarnaar wordt verwezen, misschien nog niet helemaal zijn geladen.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      Chrome 74+

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      De ID van het proces dat de renderer voor dit frame uitvoert.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie plaatsvindt.

    • timeStamp

      getal

      De tijd waarop het DOM van de pagina volledig is samengesteld, in milliseconden sinds het tijdvak.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als er een fout optreedt en de navigatie wordt afgebroken. Dit kan gebeuren als er een netwerkfout is opgetreden of als de gebruiker de navigatie heeft afgebroken.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • fout

      tekenreeks

      De foutbeschrijving.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      Chrome 74+

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      Beëindigd sinds Chrome 50

      De processId is niet meer ingesteld voor deze gebeurtenis.

      De waarde van -1.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie plaatsvindt.

    • timeStamp

      getal

      De tijd waarop de fout is opgetreden, in milliseconden sinds het tijdperk.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als de geschiedenis van het frame is geüpdatet naar een nieuwe URL. Alle toekomstige afspraken voor die lijst gebruiken de geüpdatete URL.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      Chrome 74+

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      De ID van het proces dat de renderer voor dit frame uitvoert.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie plaatsvindt.

    • timeStamp

      getal

      De tijd waarop de navigatie is vastgelegd, in milliseconden sinds het tijdperk.

    • transitionQualifiers

      TransitionQualifier[]

      Een lijst met overgangskwalificaties.

    • transitionType

      TransitionType

      Oorzaak van de navigatie.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

Wordt geactiveerd als het referentiefragment van een frame is geüpdatet. Alle toekomstige afspraken voor die lijst gebruiken de geüpdatete URL.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • documentId

      tekenreeks

      Chrome 106+

      Een UUID van het geladen document.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      De levenscyclus waarin het document zich bevindt.

    • frameId

      getal

      0 geeft aan dat de navigatie plaatsvindt in het venster met tabbladcontent. Een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

      Het type frame waarin de navigatie heeft plaatsgevonden.

    • parentDocumentId

      tekenreeks optioneel

      Chrome 106+

      Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen bovenliggende property is.

    • parentFrameId

      getal

      Chrome 74+

      De ID van het bovenliggende frame of -1 als dit het hoofdframe is.

    • processId

      getal

      De ID van het proces dat de renderer voor dit frame uitvoert.

    • tabId

      getal

      De ID van het tabblad waarin de navigatie plaatsvindt.

    • timeStamp

      getal

      De tijd waarop de navigatie is vastgelegd, in milliseconden sinds het tijdperk.

    • transitionQualifiers

      TransitionQualifier[]

      Een lijst met overgangskwalificaties.

    • transitionType

      TransitionType

      Oorzaak van de navigatie.

    • url

      tekenreeks

• filters

  object optioneel

  • url

    events.UrlFilter[]

    Voorwaarden waaraan de URL waarnaar wordt genavigeerd, moet voldoen.

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

Wordt geactiveerd als de content van het tabblad wordt vervangen door een ander (meestal eerder vooraf gerenderd) tabblad.

Parameters

• callback

  functie

  De parameter callback ziet er zo uit:

  (details: object) => void

  • details

    object

    • replacedTabId

      getal

      De ID van het tabblad dat is vervangen.

    • tabId

      getal

      De ID van het tabblad dat het oude tabblad heeft vervangen.

    • timeStamp

      getal

      De tijd waarop de vervanging heeft plaatsgevonden, in milliseconden sinds het tijdvak.