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

Kullanıcının tarayıcı geçmişiyle etkileşimde bulunmak için History API'yi kullanın.

Geçmiş API'sini kullanmak için "history" iznini uzantı manifest dosyasında bildirin. Örneğin:

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

Kavramlar ve kullanım

Geçiş türleri

History API, 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, bir 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 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()

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

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

Parametreler

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

deleteAll()

chrome.history.deleteAll(): Promise<void>

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

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

deleteRange()

chrome.history.deleteRange(
  range: object,
): 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.

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

deleteUrl()

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

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

Parametreler

İadeler

  • Promise<void>

    Chrome 96 veya daha yeni bir sürüm

getVisits()

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

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

Parametreler

İadeler

  • Promise<VisitItem[]>

    Chrome 96 veya daha yeni bir sürüm 
chrome.history.search(
  query: object,
): 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.

İadeler

  • Promise<HistoryItem[]>

    Chrome 96 veya daha yeni bir sürüm

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ı