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 lopende navigatieverzoeken.

Toestemmingen

webNavigation

Manifest

Voor alle methoden en gebeurtenissen chrome.webNavigation is het vereist dat u de machtiging "webNavigation" in het extensiemanifest declareert. Bijvoorbeeld:

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

Volgorde van gebeurtenissen

Bij een succesvol voltooide navigatie worden de volgende gebeurtenissen in de aangegeven volgorde geactiveerd:

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

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

Als een navigerend frame subframes bevat, wordt onCommitted ervan geactiveerd vóór onBeforeNavigate van elk van de onderliggende frames; terwijl onCompleted wordt geactiveerd ná onCompleted van alle onderliggende frames.

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 te wijzigen (bijvoorbeeld met history.pushState() ), wordt een onHistoryStateUpdated -gebeurtenis geactiveerd. Deze gebeurtenis kan op elk moment na onDOMContentLoaded worden geactiveerd.

Als een pagina via de navigatie vanuit de backforward-cache wordt geladen, wordt de onDOMContentLoaded -gebeurtenis niet geactiveerd. Deze gebeurtenis wordt niet geactiveerd omdat de inhoud al volledig geladen was toen de pagina voor het eerst werd bezocht.

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

Relatie tot webRequest-gebeurtenissen

Er is geen vaste volgorde tussen gebeurtenissen van de webRequest API en 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 volledig zijn geladen.

Over het algemeen zijn de webNavigation-gebeurtenissen nauw verbonden met de navigatiestatus die in de gebruikersinterface wordt weergegeven, terwijl de webRequest-gebeurtenissen overeenkomen met de status van de netwerkstack, die doorgaans niet zichtbaar is voor de gebruiker.

Tab-ID's

Niet alle navigatietabbladen komen overeen met daadwerkelijke tabbladen in de Chrome-gebruikersinterface, 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 via webNavigation.getFrame of webNavigation.getAllFrames . Zodra een dergelijk tabblad wordt ingevoegd, wordt een onTabReplaced gebeurtenis geactiveerd en worden ze toegankelijk via deze API's.

Tijdstempels

Het is belangrijk om te weten dat bepaalde technische eigenaardigheden in de manier waarop het besturingssysteem verschillende Chrome-processen afhandelt, ervoor kunnen zorgen dat de klok niet altijd gelijk loopt tussen de browser zelf en extensieprocessen. Dit betekent dat timeStamp eigenschap van de gebeurtenissen van WebNavigation alleen intern consistent is. Het vergelijken van de ene gebeurtenis met de andere geeft de juiste tijdsafstand, maar het vergelijken ervan met de huidige tijd binnen de extensie (bijvoorbeeld via (new Date()).getTime() ) kan 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 subframes is een positief getal. Zodra een document in een frame is opgebouwd, blijft de frame-ID constant gedurende de levensduur van het document. Vanaf Chrome 49 blijft deze ID ook constant gedurende de levensduur van het frame (ook bij meerdere navigaties).

Vanwege de multiprocess-architectuur van Chrome kan een tabblad verschillende processen gebruiken om de bron en de bestemming van een webpagina weer te geven. Als een navigatie dus in een nieuw proces plaatsvindt, kunt u gebeurtenissen ontvangen van zowel de nieuwe als de oude pagina totdat de nieuwe navigatie is voltooid (d.w.z. de onCommitted gebeurtenis voor het nieuwe hoofdvenster wordt verzonden). Met andere woorden, het is mogelijk dat er meerdere openstaande reeksen webNavigation-gebeurtenissen met dezelfde frameId zijn. De reeksen kunnen worden onderscheiden door de sleutel processId .

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

Een ander concept dat problematisch is bij extensies, is de levenscyclus van het frame. Een frame bevat een document (dat is gekoppeld aan een vastgelegde URL). Het document kan veranderen (bijvoorbeeld door te navigeren), maar de frame-ID blijft hetzelfde. Daardoor is het lastig om aan de hand van frame-ID's te koppelen dat er iets in een specifiek document is gebeurd. We introduceren daarom het concept van een document-ID , een unieke identificatiecode per document. Als er vanuit een frame wordt genavigeerd en een nieuw document wordt geopend, verandert de identificatiecode. Dit veld is handig om te bepalen wanneer pagina's van levenscyclusstatus veranderen (tussen pre-rendering/actief/gecacheerd), omdat de identificatiecode dan hetzelfde blijft.

Overgangstypen en -kwalificaties

De onCommitted gebeurtenis van de `webNavigation`-API heeft een ` transitionType en een ` transitionQualifiers eigenschap. Het overgangstype is hetzelfde als dat in de `history`-API wordt gebruikt om te beschrijven hoe de browser naar deze specifieke URL is genavigeerd. Daarnaast kunnen er verschillende overgangskwalificaties worden geretourneerd die de navigatie verder definiëren.

De volgende overgangsvoorwaarden zijn van toepassing:

Overgangskwalificatie	Beschrijving
"client_redirect"	Tijdens de navigatie hebben zich een of meer omleidingen voorgedaan als gevolg van JavaScript of meta refresh-tags op de pagina.
"server_redirect"	Tijdens de navigatie hebben zich een of meer omleidingen voorgedaan als gevolg van HTTP-headers die door de server zijn verzonden.
"vooruit_achteruit"	De gebruiker heeft de knop 'Vooruit' of 'Terug' gebruikt om de navigatie te starten.
"van_adresbalk"	De gebruiker startte de navigatie vanuit de adresbalk (ook wel Omnibox genoemd).

Voorbeelden

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

Soorten

TransitionQualifier

Chrome 44+

Enum

"client_redirect"

"server_redirect"

"vooruit_achteruit"

"van_adresbalk"

TransitionType

Chrome 44+

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

Enum

"link"

"getypt"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"gegenereerd"

"start_page"

"formulier_verzenden"

"herladen"

"trefwoord"

"trefwoord_gegenereerd"

Methoden

getAllFrames()

Belofte

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

Haalt informatie op over alle frames van een bepaald tabblad.

Parameters

details
voorwerp
Informatie over het tabblad waar alle frames vandaan gehaald kunnen worden.
- tabId
  nummer
  De ID van het tabblad.
terugbelverzoek
functie optioneel
De callback parameter ziet er als volgt uit:
```
(details?: object[]) => void
```
- details
  object[] optioneel
  Een lijst met frames in het opgegeven tabblad; null als de opgegeven tabblad-ID ongeldig is.
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    Documentlevenscyclus
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - Er is een fout opgetreden
    booleaans
    Retourneert 'true' als de laatste navigatie in dit frame werd onderbroken door een fout, oftewel als 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
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    nummer
    De ID van het proces dat de renderer voor dit frame uitvoert.
  - URL
    snaar
    De URL die momenteel aan dit frame is gekoppeld.

Retourneert

Promise<object[] | undefined>
Chrome 93+
Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getFrame()

Belofte

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

Haalt informatie op over het betreffende frame. Een frame verwijst naar een <iframe> of een <frame> van een webpagina en wordt geïdentificeerd door een tab-ID en een frame-ID.

Parameters

details
voorwerp
Informatie over het frame waarover gegevens moeten worden opgehaald.
- documentId
  string optioneel
  Chrome 106+
  De UUID van het document. Indien de frameId en/of tabId worden opgegeven, worden deze gecontroleerd om te zien of ze overeenkomen met het document dat is gevonden op basis van de opgegeven document-ID.
- frameId
  nummer optioneel
  De ID van het frame in het betreffende tabblad.
- proces-ID
  nummer optioneel
  Niet meer bruikbaar sinds Chrome 49.
  Frames worden nu uniek geïdentificeerd door hun tab-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.
terugbelverzoek
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 tab-ID ongeldig zijn.
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    Documentlevenscyclus
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - Er is een fout opgetreden
    booleaans
    Retourneert 'true' als de laatste navigatie in dit frame werd onderbroken door een fout, oftewel als de gebeurtenis onErrorOccurred werd geactiveerd.
  - frameType
    FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    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, indien het frame met de frameId ooit in het betreffende tabblad heeft bestaan. Het feit dat een URL aan een bepaalde frameId is gekoppeld, betekent niet dat het bijbehorende frame nog steeds bestaat.

Retourneert

Promise<object | undefined>
Chrome 93+
Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onBeforeNavigate

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

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

Parameters

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subframe. Frame-ID's zijn uniek voor een bepaalde tab en een bepaald proces.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    nummer
    Niet meer beschikbaar sinds Chrome 50.
    De processId wordt niet langer ingesteld voor deze gebeurtenis, omdat het proces dat het resulterende document zal genereren pas bekend is bij onCommit.
    De waarde van -1.
  - tabId
    nummer
    De ID van het tabblad waarin de navigatie zal plaatsvinden.
  - tijdstempel
    nummer
    Het tijdstip waarop de browser op het punt stond de navigatie te starten, in milliseconden sinds de epoch.
  - URL
    snaar
filters
object optioneel
- URL
  events.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,
)

Deze gebeurtenis wordt geactiveerd wanneer een navigatie is voltooid. Het document (en de bronnen waarnaar het verwijst, zoals afbeeldingen en subframes) worden mogelijk nog gedownload, maar ten minste een deel van het document is al van de server ontvangen en de browser heeft besloten over te schakelen naar het nieuwe document.

Parameters

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subvenster. De venster-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    Chrome 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    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 voltooid, in milliseconden sinds het beginpunt.
  - overgangskwalificaties
    TransitionQualifier []
    Een lijst met overgangscriteria.
  - overgangstype
    Overgangstype
    Oorzaak van de navigatie.
  - URL
    snaar
filters
object optioneel
- URL
  events.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

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subvenster. De venster-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    Chrome 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    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 volledig geladen was, in milliseconden sinds de epoch.
  - URL
    snaar
filters
object optioneel
- URL
  events.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,
)

Deze gebeurtenis wordt geactiveerd wanneer een nieuw venster, of een nieuw tabblad in een bestaand venster, wordt aangemaakt om een navigatie-element te hosten.

Parameters

terugbelverzoek
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.
  - bronProces-ID
    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 is geopend.
  - tijdstempel
    nummer
    Het tijdstip waarop de browser op het punt stond een nieuwe weergave te creëren, in milliseconden sinds de epoch.
  - URL
    snaar
    De URL moet in een nieuw venster worden geopend.
filters
object optioneel
- URL
  events.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,
)

Deze gebeurtenis wordt geactiveerd wanneer de DOM van de pagina volledig is opgebouwd, maar de bronnen waarnaar wordt verwezen mogelijk nog niet volledig zijn geladen.

Parameters

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subvenster. De venster-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    Chrome 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    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 de epoch.
  - URL
    snaar
filters
object optioneel
- URL
  events.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,
)

Deze gebeurtenis 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

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - fout
    snaar
    De foutbeschrijving.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subvenster. De venster-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    Chrome 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    nummer
    Niet meer beschikbaar sinds Chrome 50.
    De processId is niet langer 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 optrad, in milliseconden sinds het begin van het tijdsbestek.
  - URL
    snaar
filters
object optioneel
- URL
  events.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,
)

Deze gebeurtenis wordt geactiveerd wanneer de geschiedenis van het frame wordt bijgewerkt naar een nieuwe URL. Alle toekomstige gebeurtenissen voor dat frame zullen de bijgewerkte URL gebruiken.

Parameters

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subvenster. De venster-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    Chrome 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    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 voltooid, in milliseconden sinds het beginpunt.
  - overgangskwalificaties
    TransitionQualifier []
    Een lijst met overgangscriteria.
  - overgangstype
    Overgangstype
    Oorzaak van de navigatie.
  - URL
    snaar
filters
object optioneel
- URL
  events.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 wordt bijgewerkt. Alle toekomstige gebeurtenissen voor dat frame zullen de bijgewerkte URL gebruiken.

Parameters

terugbelverzoek
functie
De callback parameter ziet er als volgt uit:
```
(details: object) => void
```
- details
  voorwerp
  - documentId
    snaar
    Chrome 106+
    De UUID van het geladen document.
  - documentLevenscyclus
    extensionTypes.DocumentLifecycle
    Chrome 106+
    De levenscyclus waarin het document zich bevindt.
  - frameId
    nummer
    0 geeft aan dat de navigatie plaatsvindt in het venster met de tabinhoud; een positieve waarde geeft aan dat de navigatie plaatsvindt in een subvenster. De venster-ID's zijn uniek binnen een tabblad.
  - frameType
    extensionTypes.FrameType
    Chrome 106+
    Het type frame waarin de navigatie plaatsvond.
  - parentDocumentId
    string optioneel
    Chrome 106+
    De UUID van het bovenliggende document waartoe dit frame behoort. Deze wordt niet ingesteld als er geen bovenliggend document is.
  - parentFrameId
    nummer
    Chrome 74+
    De ID van het bovenliggende frame, of -1 als dit het hoofdframe is.
  - proces-ID
    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 voltooid, in milliseconden sinds het beginpunt.
  - overgangskwalificaties
    TransitionQualifier []
    Een lijst met overgangscriteria.
  - overgangstype
    Overgangstype
    Oorzaak van de navigatie.
  - URL
    snaar
filters
object optioneel
- URL
  events.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,
)

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

Parameters

terugbelverzoek
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 begin van het tijdperk.

chrome.webNavigatie Stay organized with collections Save and categorize content based on your preferences.

Beschrijving

Toestemmingen

Manifest

Volgorde van gebeurtenissen

Relatie tot webRequest-gebeurtenissen

Tab-ID's

Tijdstempels

Frame-ID's

Overgangstypen en -kwalificaties

Voorbeelden

Soorten

TransitionQualifier

Enum

TransitionType

Enum

Methoden

getAllFrames()

Parameters

Retourneert

getFrame()

Parameters

Retourneert

Evenementen

onBeforeNavigate

Parameters

onCommitted

Parameters

onCompleted

Parameters

onCreatedNavigationTarget

Parameters

onDOMContentLoaded

Parameters

onErrorOccurred

Parameters

onHistoryStateUpdated

Parameters

onReferenceFragmentUpdated

Parameters

onTabReplaced

Parameters

chrome.webNavigatie