Deze pagina is vertaald door de Cloud Translation API.

chrome.webNavigatie

Beschrijving

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

Machtigingen

webNavigation

Voor alle chrome.webNavigation methoden en -gebeurtenissen moet u de machtiging "webNavigation" opgeven in het extensiemanifest . Bijvoorbeeld:

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

Concepten en gebruik

Volgorde van evenementen

Voor een navigatie die met succes is voltooid, worden gebeurtenissen in de volgende volgorde geactiveerd:

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

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

Als een navigatieframe subframes bevat, wordt zijn onCommitted geactiveerd vóór een van zijn onderliggende frames onBeforeNavigate ; terwijl onCompleted wordt ontslagen na alle onCompleted van zijn kinderen.

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

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

Als een navigatie een pagina uit de Back Forward Cache heeft hersteld, wordt de gebeurtenis onDOMContentLoaded niet geactiveerd. De gebeurtenis wordt niet geactiveerd omdat de inhoud al is geladen toen de pagina voor het eerst werd bezocht.

Als een navigatie is geactiveerd met Chrome Instant of Instant Pages , wordt een volledig geladen pagina naar het huidige tabblad gewisseld. 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 zijn gestart, of dat een navigatie pas verdergaat nadat de netwerkbronnen al volledig zijn geladen.

Over het algemeen houden de webNavigation-gebeurtenissen nauw verband met de navigatiestatus die wordt weergegeven in de gebruikersinterface, terwijl de webRequest-gebeurtenissen overeenkomen met de status van de netwerkstack, die over het algemeen ondoorzichtig is voor de gebruiker.

Tab-ID's

Niet alle navigatietabbladen komen overeen met daadwerkelijke tabbladen in de gebruikersinterface van Chrome, bijvoorbeeld een tabblad dat vooraf wordt weergegeven. Dergelijke tabbladen zijn niet toegankelijk via de tabbladen-API en u kunt er ook geen informatie over opvragen door webNavigation.getFrame() of webNavigation.getAllFrames() aan te roepen. Zodra een dergelijk tabblad is ingewisseld, wordt een onTabReplaced gebeurtenis geactiveerd en worden ze toegankelijk via deze API's.

Tijdstempels

Het is belangrijk op te merken dat sommige technische eigenaardigheden in de manier waarop het besturingssysteem met verschillende Chrome-processen omgaat, ervoor kunnen zorgen dat de klok verschuift tussen de browser zelf en de extensieprocessen. Dat betekent dat de eigenschap timeStamp van de eigenschap timeStamp van de WebNavigation gebeurtenis alleen gegarandeerd intern consistent is. Als u de ene gebeurtenis met een andere gebeurtenis vergelijkt, krijgt u de juiste offset daartussen, maar als u ze vergelijkt met de huidige tijd binnen de extensie (bijvoorbeeld met behulp van (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. Zodra een document in een frame is geconstrueerd, 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 (over meerdere navigaties).

Vanwege het multi-proceskarakter van Chrome 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, kunt u daarom gebeurtenissen ontvangen van zowel de nieuwe als de oude pagina totdat de nieuwe navigatie is vastgelegd (dat wil zeggen dat de onCommitted gebeurtenis wordt verzonden voor het nieuwe hoofdframe). Met andere woorden, het is mogelijk om meer dan één reeks webNavigation-gebeurtenissen in behandeling te hebben met dezelfde frameId . De reeksen kunnen worden onderscheiden door de processId sleutel.

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

Een ander concept dat problematisch is bij uitbreidingen 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, en dus is het moeilijk om te associëren dat er iets in een specifiek document is gebeurd met alleen frameIds . We introduceren een concept van een documentId , een unieke identificatie per document. Als er door een frame wordt genavigeerd en een nieuw document wordt geopend, verandert de identificatie. Dit veld is handig om te bepalen wanneer pagina's hun levenscyclusstatus wijzigen (tussen prerender/actief/cache), omdat deze hetzelfde blijft.

Overgangstypen en kwalificaties

De gebeurtenis webNavigation onCommitted heeft een transitionType en een transitionQualifiers eigenschap. Het overgangstype is hetzelfde als dat wordt gebruikt in de geschiedenis-API, waarin wordt beschreven hoe de browser naar deze specifieke URL heeft genavigeerd. Bovendien kunnen er verschillende overgangskwalificaties worden geretourneerd die de navigatie verder definiëren.

Er bestaan de volgende overgangskwalificaties:

Overgangskwalificatie	Beschrijving
"client_omleiding"	Tijdens de navigatie vonden een of meer omleidingen plaats die werden veroorzaakt door JavaScript of meta-vernieuwingstags op de pagina.
"server_omleiding"	Tijdens de navigatie vonden een of meer omleidingen plaats die werden veroorzaakt door HTTP-headers die vanaf de server werden verzonden.
"vooruit_terug"	De gebruiker gebruikte de knop Vooruit of Terug om de navigatie te starten.
"van_adres_bar"	De gebruiker heeft de navigatie gestart vanuit de adresbalk (ook wel Omnibox genoemd).

Voorbeelden

Om deze API te proberen, installeert u het webNavigation API-voorbeeld uit de chrome-extension-samples- repository.

Soorten

TransitionQualifier

Chroom 44+

Enum

"client_omleiding"

"server_omleiding"

"vooruit_terug"

"van_adres_bar"

TransitionType

Chroom 44+

Oorzaak van de navigatie. Er worden dezelfde overgangstypen gebruikt als gedefinieerd in de geschiedenis-API. Dit zijn dezelfde overgangstypen als gedefinieerd in de geschiedenis-API, behalve met "start_page" in plaats van "auto_toplevel" (voor achterwaartse compatibiliteit).

Enum

"link"

"getypt"

"auto_bookmark"

"auto_subframe"

"handmatig_subframe"

"gegenereerd"

"start_pagina"

"form_submit"

"herladen"

"trefwoord"

"trefwoord_gegenereerd"

Methoden

getAllFrames()

Belofte

chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
)

Haalt informatie op over alle frames van een bepaald tabblad.

Parameters

details
voorwerp
Informatie over het tabblad waaruit alle frames moeten worden opgehaald.
- tabId
  nummer
  De ID van het tabblad.
terugbellen
functie optioneel
De callback parameter ziet er als volgt uit:
```
(details?: object[]) => void
```
- details
  object[] optioneel
  Een lijst met frames op het opgegeven tabblad, null als de opgegeven tabblad-ID ongeldig is.
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    Documentlevenscyclus
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - fout opgetreden
    Booleaans
    Waar als de laatste navigatie in dit frame werd onderbroken door een fout, dat wil zeggen dat de gebeurtenis onErrorOccurred werd geactiveerd.
  - frameId
    nummer
    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
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - URL
    snaar
    De URL die momenteel aan dit frame is gekoppeld.

Retouren

Belofte<object[] | ongedefinieerd>
Chroom 93+
Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getFrame()

Belofte

chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
)

Haalt informatie op over het opgegeven frame. 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
voorwerp
Informatie over het frame waarover u informatie wilt ophalen.
- documentId
  tekenreeks optioneel
  Chroom 106+
  De UUID van het document. Als de frameId en/of tabId worden opgegeven, worden deze gevalideerd zodat ze overeenkomen met het document dat is gevonden door de opgegeven document-ID.
- frameId
  nummer optioneel
  De ID van het frame op het opgegeven tabblad.
- procesId
  nummer optioneel
  Verouderd sinds Chrome 49
  Frames worden nu uniek geïdentificeerd aan de hand van hun tabblad-ID en frame-ID; de proces-ID is niet langer nodig en wordt daarom genegeerd.
  De ID van het proces dat de renderer voor dit tabblad uitvoert.
- tabId
  nummer optioneel
  De ID van het tabblad waarin het frame zich bevindt.
terugbellen
functie optioneel
De callback parameter ziet er als volgt 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
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    Documentlevenscyclus
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - fout opgetreden
    Booleaans
    Waar als de laatste navigatie in dit frame werd onderbroken door een fout, dat wil zeggen dat de gebeurtenis onErrorOccurred werd geactiveerd.
  - frameType
    Frametype
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - URL
    snaar
    De URL die momenteel aan dit frame is gekoppeld, als het frame dat wordt geïdentificeerd door de frameId op een bepaald punt op het opgegeven tabblad bestond. Het feit dat een URL is gekoppeld aan een gegeven frameId betekent niet dat het corresponderende frame nog steeds bestaat.

Retouren

Belofte<object | ongedefinieerd>
Chroom 93+
Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Evenementen

onBeforeNavigate

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

Wordt geactiveerd wanneer een navigatie op het punt staat plaats te vinden.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek voor een bepaald tabblad en proces.
  - frametype
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    Verouderd sinds Chrome 50
    De processId is niet langer ingesteld voor deze gebeurtenis, omdat het proces dat het resulterende document zal weergeven pas bekend is tijdens onCommit.
    De waarde van -1.
  - tabId
    nummer
    De ID van het tabblad waarop de navigatie zal plaatsvinden.
  - tijdstempel
    nummer
    Het tijdstip waarop de browser op het punt stond de navigatie te starten, in milliseconden sinds het tijdperk.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onCommitted

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

Wordt geactiveerd wanneer een navigatie wordt vastgelegd. Het document (en de bronnen waarnaar het verwijst, zoals afbeeldingen en subframes) wordt mogelijk nog steeds 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

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    Chroom 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie plaatsvindt.
  - tijdstempel
    nummer
    Het tijdstip waarop de navigatie werd uitgevoerd, in milliseconden sinds het tijdperk.
  - transitieKwalificaties
    TransitieQualifier []
    Een lijst met transitiekwalificaties.
  - transitieType
    Overgangstype
    Oorzaak van de navigatie.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onCompleted

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

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

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.
  - frametype
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    Chroom 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie plaatsvindt.
  - tijdstempel
    nummer
    Het tijdstip waarop het document is geladen, in milliseconden sinds het tijdperk.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onCreatedNavigationTarget

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

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

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - bronFrameId
    nummer
    De ID van het frame met sourceTabId waarin de navigatie wordt geactiveerd. 0 geeft het hoofdframe aan.
  - sourceProcessId
    nummer
    De ID van het proces dat de renderer voor het bronframe uitvoert.
  - bronTabId
    nummer
    De ID van het tabblad waarin de navigatie wordt geactiveerd.
  - tabId
    nummer
    De ID van het tabblad waarin de url wordt geopend
  - tijdstempel
    nummer
    Het tijdstip waarop de browser op het punt stond een nieuwe weergave te maken, in milliseconden sinds het tijdperk.
  - URL
    snaar
    De URL die in het nieuwe venster moet worden geopend.
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onDOMContentLoaded

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

Wordt geactiveerd wanneer de DOM van de pagina volledig is opgebouwd, maar de bronnen waarnaar wordt verwezen, worden mogelijk niet volledig geladen.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.
  - frametype
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    Chroom 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie plaatsvindt.
  - tijdstempel
    nummer
    Het tijdstip waarop de DOM van de pagina volledig is opgebouwd, in milliseconden sinds het tijdperk.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onErrorOccurred

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

Wordt geactiveerd wanneer 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

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - fout
    snaar
    De foutbeschrijving.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.
  - frametype
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    Chroom 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    Verouderd sinds Chrome 50
    De processId is niet meer ingesteld voor deze gebeurtenis.
    De waarde van -1.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie plaatsvindt.
  - tijdstempel
    nummer
    Het tijdstip waarop de fout is opgetreden, in milliseconden sinds het tijdperk.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onHistoryStateUpdated

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

Wordt geactiveerd wanneer de geschiedenis van het frame is bijgewerkt naar een nieuwe URL. Alle toekomstige gebeurtenissen voor dat frame gebruiken de bijgewerkte URL.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.
  - frametype
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    Chroom 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie plaatsvindt.
  - tijdstempel
    nummer
    Het tijdstip waarop de navigatie werd uitgevoerd, in milliseconden sinds het tijdperk.
  - transitieKwalificaties
    TransitieQualifier []
    Een lijst met transitiekwalificaties.
  - transitieType
    Overgangstype
    Oorzaak van de navigatie.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onReferenceFragmentUpdated

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

Wordt geactiveerd wanneer het referentiefragment van een frame is bijgewerkt. Alle toekomstige gebeurtenissen voor dat frame gebruiken de bijgewerkte URL.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chroom 106+
    Een UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chroom 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het inhoudsvenster van het tabblad; een positieve waarde geeft navigatie in een subframe aan. Frame-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chroom 106+
    Het type frame waarin de navigatie heeft plaatsgevonden.
  - parentDocumentId
    tekenreeks optioneel
    Chroom 106+
    Een UUID van het bovenliggende document dat eigenaar is van dit frame. Dit wordt niet ingesteld als er geen ouder is.
  - ouderFrameId
    nummer
    Chroom 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - procesId
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie plaatsvindt.
  - tijdstempel
    nummer
    Het tijdstip waarop de navigatie werd uitgevoerd, in milliseconden sinds het tijdperk.
  - transitieKwalificaties
    TransitieQualifier []
    Een lijst met transitiekwalificaties.
  - transitieType
    Overgangstype
    Oorzaak van de navigatie.
  - URL
    snaar
filters
object optioneel
- URL
  evenementen.UrlFilter []
  Voorwaarden waaraan de URL waarnaar wordt genavigeerd moet voldoen. De velden 'schemes' en 'ports' van UrlFilter worden voor deze gebeurtenis genegeerd.

onTabReplaced

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

Wordt geactiveerd wanneer de inhoud van het tabblad wordt vervangen door een ander (meestal eerder vooraf weergegeven) tabblad.

Parameters

terugbellen
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - vervangenTabId
    nummer
    De ID van het tabblad dat is vervangen.
  - tabId
    nummer
    De ID van het tabblad dat het oude tabblad heeft vervangen.
  - tijdstempel
    nummer
    Het tijdstip waarop de vervanging plaatsvond, in milliseconden sinds het tijdperk.