chrome.history

refresh date: 2026-09-25 robots: noindex

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

Manifest

History API'yi kullanmak için uzantı manifest dosyasında "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ü 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
"yazılan"Kullanıcı, adres çubuğuna URL'yi yazarak bu sayfaya ulaştı. 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 generated (oluşturuldu) değerine de bakın.
"auto_bookmark"Kullanıcı bu sayfaya kullanıcı arayüzündeki bir öneri (ör. menü öğesi) aracılığıyla ulaştı.
"auto_subframe"Alt çerçeve gezinmesi. Üst düzey olmayan bir çerçeveye otomatik olarak yüklenen tüm içerikler bu kapsamdadır. Ö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 (ayrıca bkz. manual_subframe).
"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. Açıkça istenen bir kare, otomatik olarak yüklenen bir kareden muhtemelen daha önemlidir. Çünkü kullanıcı, istenen karenin yüklenmesini muhtemelen önemser.
"generated"Kullanıcı, adres çubuğuna yazıp URL'ye benzemeyen bir giriş seçerek bu sayfaya ulaştı. Örneğin, bir eşleşme Google arama sonuçları 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 bkz. anahtar kelime.
"auto_toplevel"Sayfa, komut satırında belirtilmiştir 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öndermenin bu geçiş türüyle sonuçlanmadığını unutmayın.
"yeniden yükle"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.
"anahtar kelime"URL, varsayılan arama motoru dışında değiştirilebilir bir anahtar kelimeden oluşturulmuştur. keyword_generated bölümünü de inceleyin.
"keyword_generated"Bir anahtar kelime için oluşturulan ziyarete karşılık gelir. Ayrıca bkz. anahtar kelime.

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

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+

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

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

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

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

deleteAll()

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

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

Parametreler

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

deleteRange()

Taahhüt 
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 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.

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

deleteUrl()

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

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

Parametreler

  • ayrıntılar

    UrlDetails

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getVisits()

Taahhüt 
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

    function isteğe bağlı

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

    (results: VisitItem[]) => void

İadeler

  • Promise<VisitItem[]>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Taahhüt 
chrome.history.search(
  query: object,
  callback?: function,
): 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.

  • callback

    function isteğe bağlı

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

    (results: HistoryItem[]) => void

İadeler

  • Promise<HistoryItem[]>

    Chrome 96+

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onVisited

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

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

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