browser.history

Açıklama

Tarayıcının ziyaret edilen sayfalar kaydıyla etkileşimde bulunmak için chrome.history API'sini kullanın. Tarayıcı geçmişine URL ekleyebilir, geçmişten URL kaldırabilir ve geçmişteki 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.

History API'yi kullanmak için uzantı manifest dosyasında "history" iznini belirtin. Ö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, 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

Geçmiş sorgusunun bir 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 (epoch'tan bu yana milisaniye cinsinden gösterilir).

  • title

    string isteğe bağlı

    Sayfanın son yüklendiği zamanki başlığı.

  • typedCount

    number isteğe bağlı

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

  • url

    string 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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

Enum

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

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

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

"manual_subframe"
Kullanıcı, bir alt çerçevedeki öğeyi seçerek bu sayfaya ulaştı.

"generated"
Kullanıcı, adres çubuğuna yazıp URL'ye benzemeyen bir giriş (ör. Google Arama önerisi) seçerek bu sayfaya ulaştı. Örneğin, bir eşleşme Google Arama sonuç sayfasının URL'sine sahip olabilir ancak kullanıcıya "Google'da ... için arama yapın" şeklinde görünebilir. Kullanıcı hedef URL'yi yazmadığı veya görmediği için bunlar, yazarak gezinmeden farklıdır. Ayrıca anahtar kelime gezinmeleriyle de ilgilidir.

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

"form_submit"
Kullanıcı, bir formdaki değerleri doldurup formu göndererek bu sayfaya 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ğunda Enter tuşuna basarak sayfayı yeniden yükledi. Oturumu geri yükleme ve kapatılan sekmeyi yeniden açma işlemlerinde de bu geçiş türü kullanılır.

"keyword"
Bu sayfanın URL'si, varsayılan arama motoru 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 Chrome 148'den itibaren browser.*

Ö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

    boole

    Chrome 115 ve sonraki sürümler Chrome 148'den itibaren browser.*

    Ziyaret bu cihazdan kaynaklanıyorsa "True" 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

    number isteğe bağlı

    Bu ziyaretin gerçekleştiği zaman (epoch'tan bu yana geçen milisaniye cinsinden).

Yöntemler

addUrl()

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

"Bağlantı" geçiş türüyle geçerli zamandaki geçmişe bir URL ekler.

Parametreler

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

deleteAll()

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

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

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

deleteRange()

browser.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 değilse sayfalar geçmişten kaldırılmaz.

Parametreler

  • aralık

    nesne

    • endTime

      sayı

      Bu tarihten önce geçmişe eklenen öğeler, epoch'tan bu yana milisaniye cinsinden gösterilir.

    • startTime

      sayı

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

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

deleteUrl()

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

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

Parametreler

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

getVisits()

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

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

Parametreler

İadeler

  • Promise<VisitItem[]>

    Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.* 
browser.history.search(
  query: object,
): Promise<HistoryItem[]>

Geçmişte sorguyla eşleşen her sayfanın son ziyaret zamanını arar.

Parametreler

  • sorgu

    nesne

    • endTime

      number isteğe bağlı

      Sonuçları, bu tarihten önce ziyaret edilenlerle sınırlandırın. Bu tarih, epoch'tan bu yana geçen milisaniye cinsinden gösterilir.

    • 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 bu yana geçen milisaniye cinsinden gösterilir. Özellik belirtilmezse varsayılan olarak 24 saat kullanılır.

    • text (metin)

      dize

      Geçmiş hizmetine yönelik serbest metin sorgusu. Tüm sayfaları almak için bu alanı boş bırakın.

İadeler

  • Promise<HistoryItem[]>

    Chrome 96 ve sonraki sürümler Chrome 148'den itibaren browser.*

Etkinlikler

onVisited

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

Bir URL ziyaret edildiğinde tetiklenir ve söz konusu URL için 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

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

  • callback

    işlev

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

    (removed: object) => void

    • kaldırıldı

      nesne

      • allHistory

        boole

        Tüm geçmiş kaldırıldıysa doğru değerini döndürür. Doğru ise URL'ler boş olur.

      • urller

        string[] isteğe bağlı