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

  • sonuç

    VisitItem[]

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

search()

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

  • sonuç

    HistoryItem[]

İ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

  • sonuç

    HistoryItem

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ı