chrome.history

Açıklama

Tarayıcının ziyaret edilen sayfalarıyla ilgili kaydıyla etkileşimde bulunmak için chrome.history API'yi kullanın. Tarayıcının 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şi" beyan etmeniz gerekir uzantı manifestinde geçmiş API'yi kullanmasına izin vermeniz gerekir. Örneğin:

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

Geçiş türleri

History API, tarayıcının belirli bir URL'ye nasıl gittiğini açıklamak için bir geçiş türü kullanır. karar verebilir. Örneğin, bir kullanıcı başka bir sayfadaki bağlantıyı tıklayarak bir sayfayı ziyaret ederse, geçiş türü "bağlantı"dır.

Aşağıdaki tabloda her bir geçiş türü açıklanmaktadır.

Geçiş türüAçıklama
"typed"Kullanıcı, bu sayfayı adres çubuğuna URL'yi yazarak aldı. Diğer uygunsuz gezinme işlemleri için de kullanılır. Ayrıca, kullanıcının URL'ye benzemeyen bir seçim seçtiğ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 üzerinden (ör. bir menü öğesi) gelmiştir.
"otomatik_alt çerçeve"Alt çerçeve gezinmesi. Bunlar, üst düzey olmayan bir çerçeveye otomatik olarak yüklenen içeriklerdir. Örneğin, bir sayfa reklam içeren birkaç çerçeveden oluşuyorsa bu reklam URL'leri bu geçiş türüne sahip olur. Kullanıcı bu sayfalardaki içeriğin ayrı bir çerçeve olduğunun farkında bile olmayabilir ve bu nedenle URL ile ilgilenmeyebilir (ayrıca bkz. manual_subframe).
"manuel_alt çerçeve"Kullanıcı tarafından açıkça istenen ve geri-ileri listesinde yeni gezinme girişleri oluşturan alt çerçeve gezinmeleri için. Kullanıcı muhtemelen istenen karenin yüklenmiş olmasıyla ilgileneceğinden, açıkça istenen bir kare otomatik olarak yüklenen bir kareden muhtemelen daha önemlidir.
"oluşturuldu"Kullanıcı, bu sayfaya adres çubuğuna yazıp URL'ye benzemeyen bir giriş seçerek ulaşmıştır. Örneğin, bir eşleşme bir Google arama sonucu sayfasının URL'sini içerebilir, ancak kullanıcıya "Google'da şunu ara: ..." olarak görünebilir. Kullanıcı hedef URL'yi yazmadığı veya görmediği için bunlar, yazılan gezinmelerle tamamen aynı değildir. Ayrıca bkz. keyword.
"otomatik_üst düzey"Sayfa, komut satırında belirtilmiş veya başlangıç sayfasıdır.
"form_gönder"Kullanıcı bir formdaki değerleri doldurup göndermiştir. Bazı durumlarda (örneğin, bir formun içerik göndermek için komut dosyası kullandığı 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üklemiştir. Oturum geri yükleme ve Kapatılan sekmeyi yeniden açma özellikleri de bu geçiş türünü kullanır.
"anahtar kelime"URL, varsayılan arama sağlayıcısından farklı bir değiştirilebilir anahtar kelimeden oluşturulmuş. Ayrıca keyword_generated konusuna da göz atın.
"anahtar_kelime_oluşturuldu"Bir anahtar kelime için oluşturulan ziyarete karşılık gelir. Ayrıca bkz. keyword.

Örnekler

Bu API'yi denemek için chrome-extension-samples bölümünden geçmiş API'si örneğini yükleyin. depodur.

Türler

HistoryItem

Bir geçmiş sorgusunun bir sonucunu kapsayan nesne.

Özellikler

  • id

    dize

    Öğenin benzersiz tanımlayıcısıdır.

  • lastVisitTime

    sayı isteğe bağlı

    Bu sayfanın en son yüklendiği zaman; dönemden bu yana geçen milisaniye cinsinden belirtilir.

  • title

    dize isteğe bağlı

    Sayfanın son yüklendiği zamandaki başlığı.

  • typedCount

    sayı isteğe bağlı

    Kullanıcının adresi yazarak bu sayfaya gitme sayısı.

  • url

    dize isteğe bağlı

    Bir kullanıcının gittiği URL.

  • visitCount

    sayı isteğe bağlı

    Kullanıcının bu sayfaya gitme sayısı.

TransitionType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Bu ziyaretin yönlendireninden gelen geçiş türü.

Enum

"link"
Kullanıcı, başka bir sayfadaki bağlantıyı tıklayarak bu sayfaya ulaştı.

"typed"
Kullanıcı, bu sayfaya adres çubuğuna URL'yi yazarak ulaşmıştır. Bu bilgi, diğer açıkça belirtilmiş gezinme işlemleri için de kullanılır.

"auto_bookmark"
Kullanıcı, bu sayfaya kullanıcı arayüzündeki bir öneri aracılığıyla (ör. bir menü öğesi) ulaştı.

"auto_subframe"
Kullanıcı, bu sayfaya istemediği bir alt çerçeve gezinmesi üzerinden (ör. önceki sayfadaki bir çerçeveye yüklenen bir reklam aracılığıyla) 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çeveden bir öğe seçerek ulaştı.

"generate"
Kullanıcı, bu sayfaya adres çubuğuna yazıp URL'ye benzemeyen bir giriş (ör. Google Arama önerisi) seçerek ulaştı. Örneğin, bir eşleşme bir Google Arama sonuç sayfasının URL'sini içerebilir, ancak kullanıcıya "Google'da şunu ara: ..." olarak görünebilir. Kullanıcı hedef URL'yi yazmadığı veya görmediği için bunlar, yazılan gezinmelerden farklıdır. Anahtar kelimeler arasında gezinmeyle de bağlantılıdır.

"auto_toplevel"
Sayfa, komut satırında belirtilmiştir veya başlangıç sayfasıdır.

"form_submit"
Kullanıcı, bu sayfaya bir forma değerleri girip formu göndererek ulaştı. Bu geçiş türü, tüm form gönderimlerinde kullanılmaz.

"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 sekmeyi 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ından farklı bir değiştirilebilir anahtar kelimeden oluşturulmuştur.

"keyword_generate"
Bir anahtar kelime için oluşturulan ziyarete karşılık gelir.

UrlDetails

Chrome 88 ve sonraki sürümler 'nı inceleyin.

Özellikler

  • url

    dize

    İşlemin URL'si. history.search() için yapılan bir çağrının döndürdüğü biçimde olmalıdır.

VisitItem

Bir URL'ye yapılan bir ziyareti kapsayan nesne.

Özellikler

  • id

    dize

    Karşılık gelen history.HistoryItem için benzersiz tanımlayıcı.

  • isLocal

    boolean

    Chrome 115 ve sonraki sürümler 'nı inceleyin.

    Ziyaret bu cihazda gerçekleştiyse doğru değerini döndürür. Farklı bir cihazdan senkronize edildiyse False (yanlış) değerini alır.

  • referringVisitId

    dize

    Yönlendirenin ziyaret kimliği.

  • geçiş

    TransitionType

    Bu ziyaretin yönlendireninden gelen geçiş türü.

  • visitId

    dize

    Bu ziyaretin benzersiz tanımlayıcısı.

  • visitTime

    sayı isteğe bağlı

    Bu ziyaretin gerçekleşme zamanı, dönemden bu yana milisaniye cinsinden gösterilir.

Yöntemler

addUrl()

Söz 'nı inceleyin.
chrome.history.addUrl(
  details: UrlDetails,
  callback?: function,
)

Geçerli andaki geçmişe "bağlantı" geçiş türü ile bir URL ekler.

Parametreler

  • ayrıntılar

    UrlDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

deleteAll()

Söz 'nı inceleyin.
chrome.history.deleteAll(
  callback?: function,
)

Geçmişteki tüm öğeleri siler.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

deleteRange()

Söz 'nı inceleyin.
chrome.history.deleteRange(
  range: object,
  callback?: function,
)

Belirtilen tarih aralığındaki tüm öğeleri geçmişten kaldırır. Tüm ziyaretler tarih aralığında olmadıkça sayfalar geçmişten kaldırılmaz.

Parametreler

  • aralık

    nesne

    • endTime

      sayı

      Bu tarihten önce geçmişe eklenen öğeler (dönemden bu yana milisaniye cinsinden gösterilir).

    • startTime

      sayı

      Bu tarihten sonra geçmişe eklenen öğeler (dönemden bu yana milisaniye cinsinden gösterilir).

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

deleteUrl()

Söz 'nı inceleyin.
chrome.history.deleteUrl(
  details: UrlDetails,
  callback?: function,
)

Belirtilen URL'nin tüm tekrarlarını geçmişten kaldırır.

Parametreler

  • ayrıntılar

    UrlDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getVisits()

Söz 'nı inceleyin.
chrome.history.getVisits(
  details: UrlDetails,
  callback?: function,
)

Bir URL'ye yapılan ziyaretlerle ilgili bilgileri alır.

Parametreler

  • ayrıntılar

    UrlDetails

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (results: VisitItem[]) => void

İadeler

  • Promise&lt;VisitItem[]&gt;

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Söz 'nı inceleyin.
chrome.history.search(
  query: object,
  callback?: function,
)

Sorguyla eşleşen her sayfanın son ziyaret zamanı için geçmişte arama yapar.

Parametreler

  • sorgu

    nesne

    • endTime

      sayı isteğe bağlı

      Sonuçları, bu tarihten önce ziyaret edilen kullanıcılarla sınırlandırın (dönemden bu yana geçen milisaniye cinsinden belirtilir).

    • maxResults

      sayı isteğe bağlı

      Alınacak maksimum sonuç sayısı. Varsayılan olarak 100 değerine ayarlanır.

    • startTime

      sayı isteğe bağlı

      Sonuçları, bu tarihten sonra ziyaret edilenlerle sınırlandırın (dönemden bu yana geçen milisaniye cinsinden belirtilir). Özellik belirtilmezse varsayılan olarak 24 saat kullanılır.

    • text (metin)

      dize

      Geçmiş hizmetine serbest metinli sorgu. Tüm sayfaları almak için bunu boş bırakın.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (results: HistoryItem[]) => void

İadeler

  • Promise&lt;HistoryItem[]&gt;

    Chrome 96 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması 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

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 tamamen silinir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (removed: object) => void

    • kaldırıldı

      nesne

      • allHistory

        boolean

        Tüm geçmiş kaldırıldıysa doğru değerini döndürür. True (doğru) ise URL'ler boş olur.

      • urller

        string[] isteğe bağlı