chrome.history

refresh date: 2026-09-25 robots: noindex

Açıklama

Ziyaret edilen sayfaların tarayıcı kaydıyla etkileşimde bulunmak için chrome.history API'yi kullanın. Tarayıcının geçmişine URL ekleyebilir, URL'leri kaldırabilir ve URL'ler için sorgu oluşturabilirsiniz. Geçmiş sayfasını kendi sürümünüzle geçersiz kılmak için Sayfaları Geçersiz Kılma bölümüne bakın.

İzinler

history

Manifest

Geçmiş API'sini kullanmak için uzantı manifestinde "history" iznini beyan etmeniz gerekir. Örneğin:

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

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ürünü 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.

Aşağıdaki tabloda her geçiş türü açıklanmaktadır.

Geçiş türüAçıklama
"typed"Kullanıcı, URL'yi adres çubuğuna yazarak bu sayfaya ulaşmıştır. Diğer açık gezinme işlemleri için de kullanılır. Kullanıcının URL'ye hiç benzemeyen bir seçim yaptığı durumlarda kullanılan oluşturuldu seçeneğine de bakın.
"auto_bookmark"Kullanıcı, bu sayfaya kullanıcı arayüzündeki bir öneri (ör. menü öğesi) aracılığıyla geldi.
"auto_subframe"Alt çerçeve navigasyonu. Bu, üst düzey olmayan bir çerçeveye otomatik olarak yüklenen tüm içeriklerdir. Örneğin, bir sayfa reklam içeren birkaç çerçeveden oluşuyorsa bu reklam URL'leri bu geçiş türüne sahiptir. Kullanıcı, bu sayfalardaki içeriğin ayrı bir çerçeve olduğunu fark etmeyebilir ve bu nedenle URL'yi önemsemeyebilir (manual_subframe'e de bakın).
"manual_subframe"Kullanıcı tarafından açıkça istenen ve geri/ileri listesinde yeni gezinme girişleri oluşturan alt çerçeve gezinmeleri için. Kullanıcı, istenen çerçevenin yüklenmesiyle ilgilendiği için açıkça istenen bir çerçeve, otomatik olarak yüklenen bir çerçeveden muhtemelen daha önemlidir.
"oluşturuldu"Kullanıcı, adres çubuğuna yazarak ve URL gibi görünmeyen bir girişi seçerek bu sayfaya geldi. Örneğin, bir eşleşme Google arama sonucu sayfasının URL'sine sahip olabilir ancak kullanıcıya "Google'da ... için arama yap" şeklinde görünebilir. Kullanıcı hedef URL'yi yazmadığı veya görmediği için bunlar yazılan gezinmelerle tam olarak aynı değildir. Ayrıca anahtar kelime konusuna da bakın.
"auto_toplevel"Sayfa, komut satırında belirtilmiş veya başlangıç sayfasıdır.
"form_submit"Kullanıcı, bir formdaki değerleri doldurup gönderdi. Bazı durumlarda (ör. bir form, içerik göndermek için komut dosyası kullandığında) form gönderme işleminin bu geçiş türüyle sonuçlanmadığını unutmayın.
"reload" (yeniden yükle)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 işlemlerinde de bu geçiş türü kullanılır.
"anahtar kelime"URL, varsayılan arama sağlayıcısı dışında değiştirilebilir bir anahtar kelimeden oluşturulmuştur. Ayrıca keyword_generated özelliğini de inceleyin.
"keyword_generated"Bir anahtar kelime için oluşturulan ziyarete karşılık gelir. Ayrıca anahtar kelime konusuna da 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ı.

  • lastVisitTime

    number isteğe bağlı

    Bu sayfanın en son yüklendiği zaman (epoch'tan 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 ve sonraki sürümler

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

Enum

"link"
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. menü öğesi) aracılığıyla geldi.

"auto_subframe"
Kullanıcı, bu sayfaya, kendisinin istemediği bir alt çerçeve gezinme işlemiyle (ör. önceki sayfadaki bir çerçeveye yüklenen reklam aracılığıyla) geldi. Bunlar her zaman geri ve ileri menülerinde 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şme Google Arama sonuç sayfasının URL'sine sahip olabilir ancak kullanıcıya "Google'da ... araması yap" şeklinde görünebilir. Bunlar, kullanıcının hedef URL'yi yazmaması veya görmemesi nedeniyle 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. 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. 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

    boole

    Chrome 115 ve sonraki sürümler

    Ziyaret bu cihazda başladıysa doğru değerini döndürür. 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 (epoch'tan bu yana geçen milisaniye cinsinden).

Yöntemler

addUrl()

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

Geçmişe, geçerli saatte "bağlantı" geçiş türüyle bir URL ekler.

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

deleteAll()

Promise 
chrome.history.deleteAll(
  callback?: function,
): Promise<void>

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

deleteRange()

Promise 
chrome.history.deleteRange(
  range: object,
  callback?: function,
): 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 (epoch'tan bu yana geçen milisaniye cinsinden).

    • startTime

      sayı

      Bu tarihten sonra geçmişe eklenen öğeler (epoch'tan bu yana geçen milisaniye cinsinden).

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

deleteUrl()

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

Belirtilen URL'nin tüm oluşumlarını geçmişten kaldırır.

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getVisits()

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

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

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    işlev isteğe bağlı

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

    (results: VisitItem[]) => void

İadeler

  • Promise<VisitItem[]>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Promise 
chrome.history.search(
  query: object,
  callback?: function,
): 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ırlandırın. Bu tarih, epoch'tan bu yana geçen süre (milisaniye cinsinden) olarak 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 beri 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.

  • callback

    işlev isteğe bağlı

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

    (results: HistoryItem[]) => void

İadeler

  • Promise<HistoryItem[]>

    Chrome 96 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

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

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

        boole

        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ı