refresh date: 2026-09-25 robots: noindex
Descrizione
Utilizza l'API chrome.history per interagire con il record delle pagine visitate del browser. Puoi aggiungere, rimuovere ed eseguire query sugli URL nella cronologia del browser. Per sostituire la pagina della cronologia con la tua versione, consulta Override Pages.
Autorizzazioni
historyManifest
Per utilizzare l'API History, devi dichiarare l'autorizzazione "history" nel manifest dell'estensione. Ad esempio:
{
"name": "My extension",
...
"permissions": [
"history"
],
...
}
Tipi di transizione
L'API History utilizza un tipo di transizione per descrivere il modo in cui il browser ha raggiunto un determinato URL durante una determinata visita. Ad esempio, se un utente visita una pagina facendo clic su un link in un'altra pagina, il tipo di transizione è "link".
La tabella seguente descrive ogni tipo di transizione.
| Tipo di transizione | Descrizione |
|---|---|
| "link" | L'utente ha raggiunto questa pagina facendo clic su un link in un'altra pagina. |
| "typed" | L'utente ha raggiunto questa pagina digitando l'URL nella barra degli indirizzi. Utilizzato anche per altre azioni di navigazione esplicite. Vedi anche generated, che viene utilizzato nei casi in cui l'utente ha selezionato una scelta che non assomigliava affatto a un URL. |
| "auto_bookmark" | L'utente è arrivato a questa pagina tramite un suggerimento nell'interfaccia utente, ad esempio tramite una voce di menu. |
| "auto_subframe" | Navigazione dei frame secondari. Si tratta di qualsiasi contenuto caricato automaticamente in un frame non di primo livello. Ad esempio, se una pagina è composta da più frame contenenti annunci, gli URL di questi annunci hanno questo tipo di transizione. L'utente potrebbe non rendersi conto che i contenuti di queste pagine sono un frame separato e, di conseguenza, potrebbe non preoccuparsi dell'URL (vedi anche manual_subframe). |
| "manual_subframe" | Per le navigazioni dei subframe richieste esplicitamente dall'utente e che generano nuove voci di navigazione nell'elenco Indietro/Avanti. Un frame richiesto esplicitamente è probabilmente più importante di un frame caricato automaticamente perché l'utente probabilmente si preoccupa del fatto che il frame richiesto sia stato caricato. |
| "generated" | L'utente ha raggiunto questa pagina digitando nella barra degli indirizzi e selezionando una voce che non sembrava un URL. Ad esempio, una corrispondenza potrebbe avere l'URL di una pagina dei risultati di ricerca di Google, ma potrebbe essere visualizzata dall'utente come "Cerca su Google…". Queste non sono esattamente uguali alle navigazioni digitate perché l'utente non ha digitato o visualizzato l'URL di destinazione. Vedi anche parola chiave. |
| "auto_toplevel" | La pagina è stata specificata nella riga di comando o è la pagina iniziale. |
| "form_submit" | L'utente ha compilato i valori in un modulo e lo ha inviato. Tieni presente che in alcune situazioni, ad esempio quando un modulo utilizza uno script per inviare contenuti, l'invio di un modulo non comporta questo tipo di transizione. |
| "reload" | L'utente ha ricaricato la pagina facendo clic sul pulsante di ricaricamento o premendo Invio nella barra degli indirizzi. Anche il ripristino della sessione e la riapertura della scheda chiusa utilizzano questo tipo di transizione. |
| "parola chiave" | L'URL è stato generato da una parola chiave sostituibile diversa dal motore di ricerca predefinito. Vedi anche keyword_generated. |
| "keyword_generated" | Corrisponde a una visita generata per una parola chiave. Vedi anche parola chiave. |
Esempi
Per provare questa API, installa l'esempio di API History dal repository chrome-extension-samples.
Tipi
HistoryItem
Un oggetto che incapsula un risultato di una query sulla cronologia.
Proprietà
-
id
stringa
L'identificatore univoco dell'elemento.
-
lastVisitTime
number optional
L'ultimo caricamento di questa pagina, rappresentato in millisecondi dall'epoch.
-
titolo
stringa facoltativa
Il titolo della pagina al momento dell'ultimo caricamento.
-
typedCount
number optional
Il numero di volte in cui l'utente ha visitato questa pagina digitando l'indirizzo.
-
url
stringa facoltativa
L'URL a cui l'utente ha eseguito la navigazione.
-
visitCount
number optional
Il numero di volte in cui l'utente ha visitato questa pagina.
TransitionType
Il tipo di transizione per questa visita dal relativo referrer.
Enum
"link"
L'utente è arrivato a questa pagina facendo clic su un link in un'altra pagina.
"typed"
L'utente è arrivato a questa pagina digitando l'URL nella barra degli indirizzi. Questo viene utilizzato anche per altre azioni di navigazione esplicite.
"auto_bookmark"
L'utente è arrivato a questa pagina tramite un suggerimento nell'interfaccia utente, ad esempio tramite una voce di menu.
"auto_subframe"
L'utente è arrivato a questa pagina tramite la navigazione in un subframe che non ha richiesto, ad esempio tramite il caricamento degli annunci in un frame della pagina precedente. Questi non generano sempre nuove voci di navigazione nei menu Indietro e Avanti.
"manual_subframe"
L'utente è arrivato a questa pagina selezionando un elemento in un frame secondario.
"generated"
L'utente è arrivato a questa pagina digitando nella barra degli indirizzi e selezionando una voce che non sembrava un URL, ad esempio un suggerimento di Ricerca Google. Ad esempio, una corrispondenza potrebbe avere l'URL di una pagina dei risultati di ricerca di Google, ma potrebbe essere visualizzata dall'utente come "Cerca su Google…". Queste navigazioni sono diverse da quelle digitate perché l'utente non ha digitato o visualizzato l'URL di destinazione. Sono anche correlate alla navigazione per parole chiave.
"auto_toplevel"
La pagina è stata specificata nella riga di comando o è la pagina iniziale.
"form_submit"
L'utente è arrivato a questa pagina compilando i valori in un modulo e inviandolo. Non tutti gli invii di moduli utilizzano questo tipo di transizione.
"reload"
L'utente ha ricaricato la pagina facendo clic sul pulsante di ricaricamento o premendo Invio nella barra degli indirizzi. Anche il ripristino della sessione e la riapertura della scheda chiusa utilizzano questo tipo di transizione.
"keyword"
L'URL di questa pagina è stato generato da una parola chiave sostituibile diversa dal motore di ricerca predefinito.
"keyword_generated"
Corrisponde a una visita generata per una parola chiave.
UrlDetails
Proprietà
-
url
stringa
L'URL dell'operazione. Deve essere nel formato restituito da una chiamata a
history.search().
VisitItem
Un oggetto che incapsula una visita a un URL.
Proprietà
-
id
stringa
L'identificatore univoco del
history.HistoryItemcorrispondente. -
isLocal
booleano
Chrome 115 e versioni successiveTrue se la visita ha avuto origine su questo dispositivo. False se è stato sincronizzato da un altro dispositivo.
-
referringVisitId
stringa
L'ID visita del referrer.
-
transizione
Il tipo di transizione per questa visita dal relativo referrer.
-
visitId
stringa
L'identificatore univoco della visita.
-
visitTime
number optional
Quando si è verificata questa visita, rappresentata in millisecondi dall'epoca.
Metodi
addUrl()
chrome.history.addUrl(
details: UrlDetails,
callback?: function,
): Promise<void>
Aggiunge un URL alla cronologia all'ora corrente con un tipo di transizione "link".
Parametri
-
dettagli
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:() => void
Resi
-
Promise<void>
Chrome 96 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
deleteAll()
chrome.history.deleteAll(
callback?: function,
): Promise<void>
Elimina tutti gli elementi dalla cronologia.
Parametri
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:() => void
Resi
-
Promise<void>
Chrome 96 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
deleteRange()
chrome.history.deleteRange(
range: object,
callback?: function,
): Promise<void>
Rimuove dalla cronologia tutti gli elementi compresi nell'intervallo di date specificato. Le pagine non verranno rimosse dalla cronologia, a meno che tutte le visite non rientrino nell'intervallo.
Parametri
-
gamma
oggetto
-
endTime
numero
Elementi aggiunti alla cronologia prima di questa data, rappresentati in millisecondi dall'epoca.
-
startTime
numero
Elementi aggiunti alla cronologia dopo questa data, rappresentati in millisecondi dall'epoca.
-
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:() => void
Resi
-
Promise<void>
Chrome 96 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
deleteUrl()
chrome.history.deleteUrl(
details: UrlDetails,
callback?: function,
): Promise<void>
Rimuove tutte le occorrenze dell'URL specificato dalla cronologia.
Parametri
-
dettagli
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:() => void
Resi
-
Promise<void>
Chrome 96 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
getVisits()
chrome.history.getVisits(
details: UrlDetails,
callback?: function,
): Promise<VisitItem[]>
Recupera le informazioni sulle visite a un URL.
Parametri
-
dettagli
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:(results: VisitItem[]) => void
-
risultati
-
Resi
-
Promise<VisitItem[]>
Chrome 96 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
search()
chrome.history.search(
query: object,
callback?: function,
): Promise<HistoryItem[]>
Cerca nella cronologia l'ora dell'ultima visita di ogni pagina corrispondente alla query.
Parametri
-
query
oggetto
-
endTime
number optional
Limita i risultati a quelli visitati prima di questa data, rappresentata in millisecondi dall'epoca.
-
maxResults
number optional
Il numero massimo di risultati da recuperare. Il valore predefinito è 100.
-
startTime
number optional
Limita i risultati a quelli visitati dopo questa data, rappresentata in millisecondi dall'epoca. Se la proprietà non viene specificata, il valore predefinito è 24 ore.
-
testo
stringa
Una query in formato libero al servizio di cronologia. Lascia vuoto questo campo per recuperare tutte le pagine.
-
-
callback
funzione elemento facoltativo
Il parametro
callbackha il seguente aspetto:(results: HistoryItem[]) => void
-
risultati
-
Resi
-
Promise<HistoryItem[]>
Chrome 96 e versioni successiveLe promise sono supportate solo per Manifest V3 e versioni successive, mentre le altre piattaforme devono utilizzare i callback.
Eventi
onVisited
chrome.history.onVisited.addListener(
callback: function,
)
Attivato quando viene visitato un URL, fornendo i dati HistoryItem per quell'URL. Questo evento viene attivato prima del caricamento della pagina.
Parametri
-
callback
funzione
Il parametro
callbackha il seguente aspetto:(result: HistoryItem) => void
-
risultato
-
onVisitRemoved
chrome.history.onVisitRemoved.addListener(
callback: function,
)
Attivato quando uno o più URL vengono rimossi dalla cronologia. Quando tutte le visite sono state rimosse, l'URL viene eliminato dalla cronologia.
Parametri
-
callback
funzione
Il parametro
callbackha il seguente aspetto:(removed: object) => void
-
rimosso
oggetto
-
allHistory
booleano
True se tutta la cronologia è stata rimossa. Se è true, gli URL saranno vuoti.
-
Url
string[] facoltativo
-
-