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

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 beyan edin. Örneğin:

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

Kavramlar ve kullanım

Geçiş türleri

History API, tarayıcının belirli bir URL'ye nasıl gittiğini açıklamak için geçiş türlerini 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ğıdakilerin listesi için referans içeriğe bakın geçiş türleri.

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

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

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.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

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.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

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.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

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.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

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.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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 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ı