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
Manifest
Geçmiş API'sini kullanmak için uzantı manifestinde "geçmiş" iznini beyan etmeniz gerekir. Örneğin:
{
"name": "My extension",
...
"permissions": [
"history"
],
...
}
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 bir geçiş türü 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.
Aşağıdaki tabloda her bir geçiş türü açıklanmaktadır.
Geçiş türü | Açıklama |
---|---|
"bağlantı" | Kullanıcı bu sayfaya başka bir sayfadaki bağlantıyı tıklayarak geldi. |
"yazıldı" | Kullanıcı, bu sayfayı adres çubuğuna URL'yi yazarak aldı. Diğer açık gezinme işlemleri için de kullanılır. Ayrıca, kullanıcının URL'ye hiç benzemeyen bir seçeneği tercih ettiği durumlar için kullanılan oluşturuldu bölümüne de bakın. |
"auto_bookmark" | Kullanıcı, bu sayfaya kullanıcı arayüzündeki bir öneri aracılığıyla (örneğin, bir menü öğesi aracılığıyla) ulaştı. |
"auto_subframe" | Alt çerçevede gezinme. Bunlar, üst düzey olmayan bir çerçevede otomatik olarak yüklenen içeriklerdir. Örneğin, bir sayfa reklam içeren birkaç çerçeveden oluşuyorsa söz konusu reklam URL'leri bu geçiş türüne sahip olur. Kullanıcı, bu sayfalardaki içeriğin ayrı bir çerçeve olduğunu bile fark etmeyebilir ve bu nedenle URL'yi önemsemiyor olabilir (ayrıca bkz. manual_subframe). |
"manuel_alt çerçeve" | Kullanıcı tarafından açık bir şekilde istenen alt çerçeve gezinmeleri ve geri-ileri listesinde yeni gezinme girişleri oluşturma için. Kullanıcı büyük olasılıkla istenen karenin yüklenmesiyle ilgilendiğinden, açıkça istenen bir kare otomatik olarak yüklenen bir kareden muhtemelen daha önemlidir. |
"oluşturuldu" | Kullanıcı, adres çubuğuna yazıp URL'ye benzemeyen bir girişi seçerek bu sayfaya gelmiştir. Ö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ılı gezinmelerle tam olarak aynı değildir. Ayrıca keyword konusuna bakın. |
"auto_toplevel" | Sayfa, komut satırında belirtilmiş veya başlangıç sayfasıysa. |
"form_submit" yazın | Kullanıcı bir formdaki değerleri doldurup gönderdi. Bir formda içerik göndermek için komut dosyası kullanılması gibi bazı durumlarda form göndermenin bu geçiş türüyle sonuçlanmadığını unutmayın. |
"yeniden yükle" | 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 işlemleri de bu geçiş türünü kullanır. |
"anahtar kelime" | URL, varsayılan arama sağlayıcısının dışında değiştirilebilir bir anahtar kelimeden oluşturulmuş. Ayrıca bkz. keyword_generated. |
"keyword_generated" | Bir anahtar kelime için oluşturulan ziyarete karşılık gelir. Ayrıca keyword konusuna 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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
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ı
-
-