Açıklama
Tarayıcının ziyaret edilen sayfa kaydıyla etkileşim kurmak için chrome.history
API'sini kullanın. Tarayıcı geçmişindeki URL'leri ekleyebilir, kaldırabilir ve sorgulayabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları Geçersiz Kılma konusuna bakın.
İzinler
history
Kullanıcının tarayıcı geçmişiyle etkileşimde bulunmak için geçmiş API'sini kullanın.
Geçmiş API'sini kullanmak için uzantı manifestinde "history"
iznini tanımlayın. Örneğin:
{
"name": "My extension",
...
"permissions": [
"history"
],
...
}
Kavramlar ve kullanım
Geçiş türleri
Geçmiş API'si, tarayıcının belirli bir ziyarette belirli bir URL'ye nasıl gittiğini açıklamak için geçiş türlerini kullanır. Örneğin, kullanıcı başka bir sayfadaki bağlantıyı tıklayarak bir sayfayı ziyaret ederse geçiş türü "bağlantı" olur. Geçiş türlerinin listesi için referans içeriğe bakın.
Örnekler
Bu API'yi denemek için chrome-extension-samples deposundan history API örneğini yükleyin.
Türler
HistoryItem
Bir geçmiş sorgusunun sonucunu içeren bir nesne.
Özellikler
-
id
dize
Öğenin benzersiz tanımlayıcısıdır.
-
lastVisitTime
numara isteğe bağlı
Bu sayfanın son yüklendiği zaman. Dönemden bu yana geçen milisaniye cinsinden gösterilir.
-
title
string isteğe bağlı
Sayfanın son yüklendiği zamanki başlığı.
-
typedCount
numara isteğe bağlı
Kullanıcının adresi yazarak bu sayfaya gitme sayısı.
-
url
string isteğe bağlı
Bir kullanıcının ziyaret ettiği URL.
-
visitCount
numara isteğe bağlı
Kullanıcının bu sayfaya gitme sayısı.
Enum
"link"
Kullanıcı bu sayfaya başka bir sayfadaki bağlantıyı tıklayarak geldi.
"typed"
Kullanıcı, bu sayfaya URL'yi adres çubuğuna yazarak ulaştı. Bu, diğer açık gezinme işlemleri için de kullanılır.
"auto_bookmark"
Kullanıcı, bu sayfaya kullanıcı arayüzündeki bir öneri üzerinden, örneğin bir menü öğesi üzerinden geldi.
"auto_subframe"
Kullanıcı, bu sayfaya istemediği bir alt çerçeve gezinmesi üzerinden (ör. önceki sayfada bir çerçeveye yüklenen bir reklam) ulaştı. Bunlar geri ve ileri menülerinde her zaman yeni gezinme girişleri oluşturmaz.
"manual_subframe"
Kullanıcı bu sayfaya bir alt çerçevede bir öğe seçerek ulaştı.
"generate"
Kullanıcı, adres çubuğuna yazıp URL'ye benzemeyen bir girişi (ör. Google Arama önerisi) seçerek bu sayfaya ulaşmıştır. Örneğin, bir eşleşme bir Google Arama sonucu sayfasının URL'sine sahip olabilir, ancak bu URL kullanıcıya "Google'da ara ..." olarak görünebilir. Kullanıcı, hedef URL'yi yazmadığı veya görmediği için bunlar, yazılmış gezinmelerden farklıdır. Anahtar kelime bazında gezinmeyle de alakalıdır.
"auto_toplevel"
Sayfa, komut satırında belirtilmiş veya başlangıç sayfasıdır.
"form_submit"
Kullanıcı, bu sayfaya bir forma değerler doldurup formu göndererek ulaştı. Tüm form gönderimlerinde bu geçiş türü kullanılmaz.
"reload"
Kullanıcı, yeniden yükle düğmesini tıklayarak veya adres çubuğundaki Enter tuşuna basarak sayfayı yeniden yükledi. Oturum geri yükleme ve Kapatılan sekmeleri yeniden açma da bu geçiş türünü kullanır.
"keyword"
Bu sayfanın URL'si, varsayılan arama sağlayıcısı dışındaki değiştirilebilir bir anahtar kelimeden oluşturulmuştur.
"keyword_generated"
Bir anahtar kelime için oluşturulan ziyarete karşılık gelir.
UrlDetails
Özellikler
-
url
dize
İşlemin URL'si. Bu değer,
history.search()
için yapılan çağrıda döndürülen biçimde olmalıdır.
VisitItem
Bir URL'ye yapılan bir ziyareti kapsayan bir nesne.
Özellikler
-
id
dize
Karşılık gelen
history.HistoryItem
için benzersiz tanımlayıcı. -
isLocal
boolean
Chrome 115 ve sonraki sürümlerZiyaret bu cihazda gerçekleştiyse doğru değerini alır. Farklı bir cihazdan senkronize edildiyse yanlış değerini alır.
-
referringVisitId
dize
Yönlendirenin ziyaret kimliği.
-
geçiş
Bu ziyaretin yönlendireninden alınan geçiş türü.
-
visitId
dize
Bu ziyaretin benzersiz tanımlayıcısı.
-
visitTime
numara isteğe bağlı
Bu ziyaretin gerçekleşme zamanı. Dönemden bu yana geçen milisaniye cinsinden gösterilir.
Yöntemler
addUrl()
chrome.history.addUrl(
details: UrlDetails,
callback?: function,
)
O anki geçmişe "bağlantı" geçiş türüyle ilgili bir URL ekler.
Parametreler
-
ayrıntılar
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
deleteAll()
chrome.history.deleteAll(
callback?: function,
)
Geçmişteki tüm öğeleri siler.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
deleteRange()
chrome.history.deleteRange(
range: object,
callback?: function,
)
Belirtilen tarih aralığındaki tüm öğeleri geçmişten kaldırır. Tüm ziyaretler bu aralıkta olmadığı sürece sayfalar geçmişten kaldırılmaz.
Parametreler
-
aralık
nesne
-
endTime
sayı
Bu tarihten önce geçmişe eklenen öğeler (sıfır zamandan itibaren milisaniye cinsinden gösterilir).
-
startTime
sayı
Bu tarihten sonra geçmişe eklenen öğeler (sıfır zamandan itibaren milisaniye cinsinden gösterilir).
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
deleteUrl()
chrome.history.deleteUrl(
details: UrlDetails,
callback?: function,
)
Belirtilen URL'nin geçtiği tüm yerleri geçmişten kaldırır.
Parametreler
-
ayrıntılar
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getVisits()
chrome.history.getVisits(
details: UrlDetails,
callback?: function,
)
Bir URL'ye yapılan ziyaretlerle ilgili bilgileri getirir.
Parametreler
-
ayrıntılar
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(results: VisitItem[]) => void
-
sonuç
-
İlerlemeler
-
Promise<VisitItem[]>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
search()
chrome.history.search(
query: object,
callback?: function,
)
Sorguyla eşleşen her sayfanın son ziyaret zamanı için geçmişinde arama yapar.
Parametreler
-
sorgu
nesne
-
endTime
numara isteğe bağlı
Sonuçları, bu tarihten önce ziyaret edilenlerle sınırlandırın. Dönemden bu yana geçen milisaniye cinsinden gösterilir.
-
maxResults
numara isteğe bağlı
Alınacak maksimum sonuç sayısı. Varsayılan olarak 100 değerine ayarlanır.
-
startTime
numara isteğe bağlı
Sonuçları, bu tarihten sonra ziyaret edilenlerle sınırlandırın (epoch'tan beri geçen milisaniye cinsinden). Özellik belirtilmezse varsayılan olarak 24 saat kullanılır.
-
text (metin)
dize
Geçmiş hizmetine serbest metin sorgusu gönderilir. Tüm sayfaları almak için bu alanı boş bırakın.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(results: HistoryItem[]) => void
-
sonuç
-
İlerlemeler
-
Promise<HistoryItem[]>
Chrome 96 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
Etkinlikler
onVisited
chrome.history.onVisited.addListener(
callback: function,
)
Bir URL ziyaret edildiğinde tetiklenir ve bu URL için HistoryItem
verileri sağlanır. Bu etkinlik, sayfa yüklenmeden önce tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(result: HistoryItem) => void
-
sonuç
-
onVisitRemoved
chrome.history.onVisitRemoved.addListener(
callback: function,
)
Bir veya daha fazla URL geçmişten kaldırıldığında tetiklenir. Tüm ziyaretler kaldırıldığında URL, geçmişten silinir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(removed: object) => void
-
kaldırılmış
nesne
-
allHistory
boolean
Tüm geçmiş kaldırıldıysa doğru değerini döndürür. Doğru değerine ayarlanırsa URL'ler boş olur.
-
urls
string[] isteğe bağlı
-
-