chrome.geschiedenis

Vernieuwingsdatum: 2026-09-25 robots: noindex

Beschrijving

Gebruik de chrome.history API om te communiceren met de pagina's die de browser heeft bezocht. Je kunt URL's toevoegen, verwijderen en opvragen in de browsergeschiedenis. Zie Pagina's overschrijven om de geschiedenispagina te vervangen door je eigen versie.

Toestemmingen

history

Manifest

Om de geschiedenis-API te kunnen gebruiken, moet u de machtiging "geschiedenis" in het extensiemanifest declareren. Bijvoorbeeld:

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

Overgangstypen

De History API gebruikt een overgangstype om te beschrijven hoe de browser tijdens een bepaald bezoek naar een specifieke URL is genavigeerd. Als een gebruiker bijvoorbeeld een pagina bezoekt door op een link op een andere pagina te klikken, is het overgangstype 'link'.

De volgende tabel beschrijft elk overgangstype.

Overgangstype Beschrijving
"getypt" De gebruiker kreeg deze pagina te zien door de URL in de adresbalk te typen. Deze pagina wordt ook gebruikt voor andere expliciete navigatieacties. Zie ook 'generated' , wat wordt gebruikt in gevallen waarin de gebruiker een keuze maakte die helemaal niet op een URL leek.
"auto_bookmark" De gebruiker is op deze pagina terechtgekomen via een suggestie in de gebruikersinterface, bijvoorbeeld via een menu-item.
"auto_subframe" Subframe-navigatie. Dit betreft alle inhoud die automatisch wordt geladen in een frame dat zich niet op het hoogste niveau bevindt. Als een pagina bijvoorbeeld bestaat uit meerdere frames met advertenties, hebben de URL's van die advertenties dit overgangstype. De gebruiker realiseert zich mogelijk niet eens dat de inhoud op deze pagina's zich in een apart frame bevindt en is daarom wellicht niet geïnteresseerd in de URL (zie ook manual_subframe ).
"manual_subframe" Voor navigaties naar subframes die expliciet door de gebruiker worden aangevraagd en nieuwe navigatie-items genereren in de terug/vooruit-lijst. Een expliciet aangevraagd frame is waarschijnlijk belangrijker dan een automatisch geladen frame, omdat de gebruiker er waarschijnlijk waarde aan hecht dat het aangevraagde frame daadwerkelijk is geladen.
"gegenereerd" De gebruiker is op deze pagina terechtgekomen door iets in de adresbalk te typen en een resultaat te selecteren dat er niet uitzag als een URL. Een resultaat kan bijvoorbeeld de URL van een Google-zoekresultatenpagina bevatten, maar voor de gebruiker kan het eruitzien als 'Zoek op Google naar ...'. Dit is niet helemaal hetzelfde als navigatie via een getypte URL, omdat de gebruiker de bestemmings-URL niet heeft ingetypt of gezien. Zie ook trefwoord .
"auto_toplevel" De pagina is opgegeven in de opdrachtregel of is de startpagina.
"formulier_verzenden" De gebruiker heeft waarden ingevuld in een formulier en dit verzonden. Houd er rekening mee dat in sommige situaties – bijvoorbeeld wanneer een formulier scripts gebruikt om inhoud te verzenden – het verzenden van een formulier niet resulteert in dit type overgang.
"herladen" De gebruiker heeft de pagina opnieuw geladen, door op de vernieuwingsknop te klikken of door op Enter in de adresbalk te drukken. Sessieherstel en het heropenen van een gesloten tabblad gebruiken ook dit overgangstype.
"trefwoord" De URL is gegenereerd op basis van een vervangbaar zoekwoord dat afwijkt van de standaard zoekprovider. Zie ook keyword_generated .
"trefwoord_gegenereerd" Komt overeen met een bezoek dat gegenereerd is voor een zoekwoord. Zie ook zoekwoord .

Voorbeelden

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

Soorten

HistoryItem

Een object dat één resultaat van een historiequery bevat.

Eigenschappen

  • id

    snaar

    De unieke identificatiecode voor het item.

  • laatste bezoektijd

    nummer optioneel

    Het tijdstip waarop deze pagina voor het laatst is geladen, weergegeven in milliseconden sinds het begin van het tijdperk.

  • titel

    string optioneel

    De titel van de pagina zoals deze was toen deze voor het laatst werd geladen.

  • getyptAantal

    nummer optioneel

    Het aantal keren dat de gebruiker naar deze pagina is genavigeerd door het adres in te typen.

  • URL

    string optioneel

    De URL waarnaar een gebruiker is doorgestuurd.

  • bezoekAantal

    nummer optioneel

    Het aantal keren dat de gebruiker deze pagina heeft bezocht.

TransitionType

Chrome 44+

Het overgangstype voor dit bezoek vanuit de verwijzende pagina.

Enum

"link"
De gebruiker is op deze pagina terechtgekomen door op een link op een andere pagina te klikken.

"getypt"
De gebruiker is op deze pagina terechtgekomen door de URL in de adresbalk te typen. Deze URL wordt ook gebruikt voor andere expliciete navigatieacties.

"auto_bookmark"
De gebruiker is op deze pagina terechtgekomen via een suggestie in de gebruikersinterface, bijvoorbeeld via een menu-item.

"auto_subframe"
De gebruiker is op deze pagina terechtgekomen via een subframe-navigatie die hij of zij niet heeft aangevraagd, bijvoorbeeld doordat een advertentie in een frame op de vorige pagina werd geladen. Dergelijke subframes genereren niet altijd nieuwe navigatie-items in de terug- en vooruitmenu's.

"manual_subframe"
De gebruiker is op deze pagina terechtgekomen door iets in een subframe te selecteren.

"gegenereerd"
The user arrived at this page by typing in the address bar and selecting an entry that didn't look like a URL, such as a Google Search suggestion. For example, a match might have the URL of a Google Search result page, but it might appear to the user as "Search Google for ...". These are different from typed navigations because the user didn't type or see the destination URL. They're also related to keyword navigations.

"auto_toplevel"
De pagina is opgegeven in de opdrachtregel of is de startpagina.

"formulier_verzenden"
De gebruiker is op deze pagina terechtgekomen door waarden in een formulier in te vullen en het formulier te verzenden. Niet alle formulierinzendingen gebruiken dit overgangstype.

"herladen"
De gebruiker heeft de pagina opnieuw geladen, door op de vernieuwingsknop te klikken of door op Enter in de adresbalk te drukken. Sessieherstel en het heropenen van een gesloten tabblad maken ook gebruik van dit overgangstype.

"trefwoord"
De URL voor deze pagina is gegenereerd op basis van een vervangbaar zoekwoord dat afwijkt van de standaard zoekprovider.

"trefwoord_gegenereerd"
Komt overeen met een bezoek dat gegenereerd is voor een zoekwoord.

UrlDetails

Chrome 88+

Eigenschappen

  • URL

    snaar

    De URL voor de bewerking. Deze moet de indeling hebben zoals die wordt geretourneerd door een aanroep van history.search() .

VisitItem

Een object dat één bezoek aan een URL omvat.

Eigenschappen

  • id

    snaar

    De unieke identificatiecode voor het bijbehorende history.HistoryItem .

  • isLokaal

    booleaans

    Chrome 115+

    Waar als het bezoek vanaf dit apparaat is gestart. Onwaar als het vanaf een ander apparaat is gesynchroniseerd.

  • verwijzende Bezoek-ID

    snaar

    Het bezoek-ID van de verwijzer.

  • overgang

    Overgangstype

    Het overgangstype voor dit bezoek vanuit de verwijzende pagina.

  • bezoekID

    snaar

    De unieke identificatiecode voor dit bezoek.

  • bezoekTijd

    nummer optioneel

    Het tijdstip waarop dit bezoek plaatsvond, weergegeven in milliseconden sinds het tijdstip.

Methoden

addUrl()

Belofte
chrome.history.addUrl(
  details: UrlDetails,
  callback?: function,
): Promise<void>

Voegt een URL toe aan de geschiedenis op het huidige tijdstip met een overgangstype "link".

Parameters

  • details

    URL-details

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

deleteAll()

Belofte
chrome.history.deleteAll(
  callback?: function,
): Promise<void>

Verwijdert alle items uit de geschiedenis.

Parameters

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

deleteRange()

Belofte
chrome.history.deleteRange(
  range: object,
  callback?: function,
): Promise<void>

Verwijdert alle items binnen het opgegeven datumbereik uit de geschiedenis. Pagina's worden alleen uit de geschiedenis verwijderd als alle bezoeken binnen het opgegeven bereik vallen.

Parameters

  • bereik

    voorwerp

    • eindtijd

      nummer

      Items die vóór deze datum aan de geschiedenis zijn toegevoegd, weergegeven in milliseconden sinds het tijdperk.

    • starttijd

      nummer

      Items die na deze datum aan de geschiedenis zijn toegevoegd, weergegeven in milliseconden sinds het tijdperk.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

deleteUrl()

Belofte
chrome.history.deleteUrl(
  details: UrlDetails,
  callback?: function,
): Promise<void>

Verwijdert alle voorkomende gevallen van de opgegeven URL uit de geschiedenis.

Parameters

  • details

    URL-details

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retourneert

  • Promise<void>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

getVisits()

Belofte
chrome.history.getVisits(
  details: UrlDetails,
  callback?: function,
): Promise<VisitItem[]>

Haalt informatie op over bezoeken aan een URL.

Parameters

  • details

    URL-details

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: VisitItem[]) => void

Retourneert

  • Promise< VisitItem []>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Belofte
chrome.history.search(
  query: object,
  callback?: function,
): Promise<HistoryItem[]>

Zoekt in de geschiedenis naar het tijdstip van het laatste bezoek aan elke pagina die aan de zoekopdracht voldoet.

Parameters

  • vraag

    voorwerp

    • eindtijd

      nummer optioneel

      Beperk de resultaten tot de bezoeken vóór deze datum, weergegeven in milliseconden sinds het begin van het tijdperk.

    • maxResultaten

      nummer optioneel

      Het maximale aantal resultaten dat moet worden opgehaald. Standaardwaarde is 100.

    • starttijd

      nummer optioneel

      Beperk de resultaten tot websites die na deze datum zijn bezocht, weergegeven in milliseconden sinds het begin van het jaar. Als deze eigenschap niet is gespecificeerd, wordt standaard 24 uur gebruikt.

    • tekst

      snaar

      Een zoekopdracht in vrije tekst voor de geschiedenisservice. Laat dit veld leeg om alle pagina's op te halen.

  • terugbelverzoek

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: HistoryItem[]) => void

Retourneert

  • Promise< HistoryItem []>

    Chrome 96+

    Promises worden alleen ondersteund voor Manifest V3 en later; voor andere platforms moeten callbacks worden gebruikt.

Evenementen

onVisited

chrome.history.onVisited.addListener(
  callback: function,
)

Deze gebeurtenis wordt geactiveerd wanneer een URL wordt bezocht en levert de HistoryItem gegevens voor die URL. Deze gebeurtenis wordt geactiveerd voordat de pagina is geladen.

Parameters

onVisitRemoved

chrome.history.onVisitRemoved.addListener(
  callback: function,
)

Wordt geactiveerd wanneer een of meer URL's uit de geschiedenis worden verwijderd. Wanneer alle bezoeken zijn verwijderd, wordt de URL definitief uit de geschiedenis gewist.

Parameters

  • terugbelverzoek

    functie

    De callback parameter ziet er als volgt uit: 

    (removed: object) => void

    • VERWIJDERD

      voorwerp

      • alleGeschiedenis

        booleaans

        Retourneert 'true' als alle geschiedenis is verwijderd. In dat geval zullen de URL's leeg zijn.

      • URL's

        string[] optioneel