chrome.history

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

TransitionType

Chrome 44 ve sonraki sürümler

Bu ziyaretin yönlendireninden alınan geçiş türü.

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

Chrome 88 ve sonraki sürümler

Ö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ümler

    Ziyaret 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ş

    TransitionType

    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()

Söz 
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

    UrlDetails

  • 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ümler

    Vaatler, 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()

Söz 
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ümler

    Vaatler, 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()

Söz 
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ümler

    Vaatler, 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()

Söz 
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

    UrlDetails

  • 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ümler

    Vaatler, 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()

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

Bir URL'ye yapılan ziyaretlerle ilgili bilgileri getirir.

Parametreler

  • ayrıntılar

    UrlDetails

  • geri çağırma

    Functions (isteğe bağlı)

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

    (results: VisitItem[])=>void

İlerlemeler

  • Promise<VisitItem[]>

    Chrome 96 ve sonraki sürümler

    Vaatler, 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.

Söz 
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

İlerlemeler

  • Promise<HistoryItem[]>

    Chrome 96 ve sonraki sürümler

    Vaatler, 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

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ı