chrome.history

Açıklama

Ziyaret edilen sayfaların tarayıcı kaydıyla etkileşimde bulunmak için chrome.history API'sini kullanın. Tarayıcının geçmişine URL ekleyebilir, URL kaldırabilir ve URL'leri sorgulayabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları Geçersiz Kılma başlıklı makaleyi inceleyin.

İzinler

history

Manifest

Geçmiş API'sini kullanmak için uzantı manifestinde "history" 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 ziyaret sırasında belirli bir URL'ye nasıl gittiğini açıklamak için geçiş türünü kullanır. Örneğin, bir 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 geçiş türü açıklanmaktadır.

Geçiş türüAçıklama
"typed"Kullanıcı, URL'yi adres çubuğuna yazarak bu sayfaya ulaşmıştır. Diğer açık gezinme işlemleri için de kullanılır. Kullanıcının URL'ye hiç benzemeyen bir seçim yaptığı durumlarda kullanılan oluşturuldu'ya da bakın.
"auto_bookmark"Kullanıcı, kullanıcı arayüzündeki bir öneri (ör. menü öğesi) aracılığıyla bu sayfaya ulaşmıştır.
"auto_subframe"Alt çerçevede gezinme Bu, üst düzey olmayan bir çerçeveye otomatik olarak yüklenen tüm içerikleri ifade eder. Örneğin, bir sayfa reklam içeren birkaç çerçeveden oluşuyorsa bu reklam URL'leri bu geçiş türüne sahiptir. Kullanıcı, bu sayfalardaki içeriğin ayrı bir çerçeve olduğunu fark etmeyebilir ve bu nedenle URL'yi önemsemeyebilir (manual_subframe'e de bakın).
"manual_subframe"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ı, istenen çerçevenin yüklenmesiyle ilgilendiği için açıkça istenen bir çerçeve, otomatik olarak yüklenen bir çerçeveden daha önemlidir.
"generated" (oluşturuldu)Kullanıcı, adres çubuğuna yazarak ve URL gibi görünmeyen bir girişi seçerek bu sayfaya geldi. Örneğin, bir eşleşmede Google arama sonucu sayfasının URL'si olabilir ancak bu URL, kullanıcıya "Google'da ... araması yap" şeklinde görünebilir. Kullanıcı hedef URL'yi yazmadığı veya görmediği için bunlar yazılan gezinmelerle tam olarak aynı değildir. Ayrıca anahtar kelime konusuna bakın.
"auto_toplevel"Sayfa, komut satırında belirtilmiş veya başlangıç sayfasıdır.
"form_submit"Kullanıcı, bir formdaki değerleri doldurup gönderdi. Formun, içerik göndermek için komut dosyası kullandığı durumlar gibi bazı durumlarda form göndermenin bu geçiş türüne yol açmadığını unutmayın.
"reload" (yeniden yükle)Kullanıcı, yeniden yükle düğmesini tıklayarak veya adres çubuğunda Enter tuşuna basarak sayfayı yeniden yükledi. 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ı dışında değiştirilebilir bir anahtar kelimeden oluşturulmuştur. Ayrıca keyword_generated özelliğini de inceleyin.
"keyword_generated"Bir anahtar kelime için oluşturulan ziyarete karşılık gelir. Ayrıca anahtar kelime 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 kapsayan nesne.

Özellikler

  • id

    dize

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

  • lastVisitTime

    number isteğe bağlı

    Bu sayfanın en son yüklendiği zaman (dönemden bu yana geçen milisaniye cinsinden süre).

  • title

    dize isteğe bağlı

    Sayfanın en son yüklendiğindeki başlığı.

  • typedCount

    number isteğe bağlı

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

  • url

    dize isteğe bağlı

    Kullanıcının gittiği URL.

  • visitCount

    number isteğe bağlı

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

TransitionType

Chrome 44 veya daha yeni bir sürüm

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

Enum

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

"typed"
Kullanıcı, URL'yi adres çubuğuna yazarak bu sayfaya geldi. 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 (ör. bir menü öğesi) aracılığıyla geldi.

"auto_subframe"
Kullanıcı, bu sayfaya, kendisinin istemediği bir alt çerçeve gezinmesiyle (ör. önceki sayfadaki bir çerçevede yüklenen reklam aracılığıyla) geldi. Bunlar, geri ve ileri menülerinde her zaman yeni gezinme girişleri oluşturmaz.

"manual_subframe"
Kullanıcı, bir alt çerçevede bir öğe seçerek bu sayfaya geldi.

"oluşturuldu"
Kullanıcı, adres çubuğuna yazarak ve URL'ye benzemeyen bir girişi (ör. Google Arama önerisi) seçerek bu sayfaya geldi. Örneğin, bir eşleşmede Google Arama sonucu sayfasının URL'si olabilir ancak kullanıcıya "Google'da ... araması yap" şeklinde görünebilir. Bunlar, kullanıcının hedef URL'yi yazmadığı veya görmediği için yazılan gezinmelerden farklıdır. Ayrıca anahtar kelime gezinmeleriyle de ilgilidir.

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

"form_submit"
Kullanıcı, bir formdaki değerleri doldurup formu göndererek bu sayfaya geldi. Form gönderimlerinin tümünde bu geçiş türü kullanılmaz.

"reload"
Kullanıcı, yeniden yükle düğmesini tıklayarak veya adres çubuğunda Enter tuşuna basarak sayfayı yeniden yükledi. Oturum geri yükleme ve Kapatılan sekmeyi yeniden açma özellikleri de bu geçiş türünü kullanır.

"keyword"
Bu sayfanın URL'si, varsayılan arama sağlayıcı dışında değiştirilebilir bir anahtar kelimeden oluşturuldu.

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

UrlDetails

Chrome 88 ve sonraki sürümler

Özellikler

  • url

    dize

    İşlemin URL'si. history.search() çağrısından döndürülen biçimde olmalıdır.

VisitItem

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

Özellikler

  • id

    dize

    İlgili history.HistoryItem için benzersiz tanımlayıcı.

  • isLocal

    boolean

    Chrome 115 veya daha yeni bir sürüm

    Ziyaret bu cihazda başladıysa doğru. Farklı bir cihazdan senkronize edildiyse yanlış.

  • referringVisitId

    dize

    Yönlendirenin ziyaret kimliği.

  • geçiş

    TransitionType

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

  • visitId

    dize

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

  • visitTime

    number isteğe bağlı

    Bu ziyaretin gerçekleştiği zaman (dönemden bu yana geçen milisaniye cinsinden).

Yöntemler

addUrl()

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

Geçerli zamanda, geçiş türü "bağlantı" olan bir URL'yi geçmişe ekler.

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

deleteAll()

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

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

deleteRange()

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

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

Parametreler

  • aralık

    nesne

    • endTime

      sayı

      Bu tarihten önce geçmişe eklenen öğeler (dönem başlangıcından itibaren milisaniye cinsinden).

    • startTime

      sayı

      Bu tarihten sonra geçmişe eklenen öğeler, epoch'tan beri geçen milisaniye cinsinden gösterilir.

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

deleteUrl()

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

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

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getVisits()

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

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

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    işlev isteğe bağlı

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

    (results: VisitItem[]) => void

İadeler

  • Promise<VisitItem[]>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

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

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

Parametreler

  • sorgu

    nesne

    • endTime

      number isteğe bağlı

      Sonuçları, bu tarihten önce ziyaret edilenlerle sınırlayın. Bu tarih, epoch'tan beri geçen milisaniye cinsinden ifade edilir.

    • maxResults

      number isteğe bağlı

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

    • startTime

      number isteğe bağlı

      Sonuçları, bu tarihten sonra ziyaret edilenlerle sınırlandırın. Epoch'tan beri geçen milisaniye olarak gösterilir. Özellik belirtilmezse varsayılan olarak 24 saat kullanılır.

    • text (metin)

      dize

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

  • callback

    işlev isteğe bağlı

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

    (results: HistoryItem[]) => void

İadeler

  • Promise<HistoryItem[]>

    Chrome 96 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onVisited

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

Bir URL ziyaret edildiğinde tetiklenir ve söz konusu URL'nin HistoryItem verilerini sağlar. Bu etkinlik, sayfa yüklenmeden önce tetiklenir.

Parametreler

  • callback

    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 temizlenir.

Parametreler

  • callback

    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. Doğruysa URL'ler boş olur.

      • urller

        string[] isteğe bağlı