chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

Açıklama

Devam eden gezinme isteklerinin durumuyla ilgili bildirim almak için chrome.webNavigation API'yi kullanın.

İzinler

webNavigation

Manifest

Tüm chrome.webNavigation yöntemleri ve etkinlikleri için uzantı manifestinde "webNavigation" iznini bildirmeniz gerekir. Örneğin:

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

Etkinlik sırası

Başarıyla tamamlanan bir gezinme için etkinlikler aşağıdaki sırayla tetiklenir:

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

İşlem sırasında oluşan herhangi bir hata onErrorOccurred etkinliğiyle sonuçlanır. Belirli bir gezinme için onErrorOccurred sonrasında başka etkinlik tetiklenmez.

Bir gezinme çerçevesi alt çerçeveler içeriyorsa onCommitted, alt öğelerinin onBeforeNavigate'sinden önce, onCompleted ise alt öğelerinin onCompleted'sinden sonra tetiklenir.

Bir karenin referans parçası değiştirilirse onReferenceFragmentUpdated etkinliği tetiklenir. Bu etkinlik, onDOMContentLoaded tarihinden sonra, onCompleted tarihinden sonra bile herhangi bir zamanda tetiklenebilir.

Bir çerçevenin durumunu değiştirmek için history API kullanılırsa (ör. history.pushState() kullanılarak) onHistoryStateUpdated etkinliği tetiklenir. Bu etkinlik, onDOMContentLoaded tarihinden sonra herhangi bir zamanda tetiklenebilir.

Bir gezinme, geri-ileri önbellekten bir sayfayı geri yüklediyse onDOMContentLoaded etkinliği tetiklenmez. Sayfa ilk kez ziyaret edildiğinde içerik yükleme işlemi tamamlandığı için etkinlik tetiklenmiyor.

Chrome Anında Arama veya Anında Sayfalar üzerinden bir gezinme tetiklendiyse tamamen yüklenmiş bir sayfa geçerli sekmede değiştirilir. Bu durumda, onTabReplaced etkinliği tetiklenir.

webRequest etkinlikleriyle ilişkisi

webRequest API etkinlikleri ile webNavigation API etkinlikleri arasında tanımlanmış bir sıralama yoktur. Yeni bir gezinmeye başlamış olan çerçeveler için webRequest etkinliklerinin hâlâ alınması veya gezinmenin yalnızca ağ kaynakları tamamen yüklendikten sonra devam etmesi mümkündür.

Genel olarak, webNavigation etkinlikleri kullanıcı arayüzünde gösterilen gezinme durumuyla yakından ilişkilidir. webRequest etkinlikleri ise genellikle kullanıcıya opak olan ağ yığını durumuna karşılık gelir.

Sekme kimlikleri

Tüm gezinme sekmeleri, Chrome'un kullanıcı arayüzündeki gerçek sekmelere karşılık gelmez (ör. önceden oluşturulan bir sekme). Bu tür sekmelere sekmeler API'si üzerinden erişilemez. Ayrıca, webNavigation.getFrame veya webNavigation.getAllFrames üzerinden bu sekmelerle ilgili bilgi isteğinde bulunamazsınız. Böyle bir sekme değiştirildiğinde onTabReplaced etkinliği tetiklenir ve bu sekmelere API'ler üzerinden erişilebilir.

Zaman damgaları

İşletim sisteminin farklı Chrome işlemlerini ele almasıyla ilgili bazı teknik tuhaflıkların, tarayıcı ile uzantı işlemleri arasında saatin yanlış gösterilmesine neden olabileceğini unutmayın. Bu, WebNavigation'ın etkinliklerinin timeStamp özelliğinin yalnızca dahili olarak tutarlı olacağı anlamına gelir. Bir etkinliği başka bir etkinlikle karşılaştırdığınızda aralarındaki doğru farkı elde edersiniz. Ancak bunları uzantıdaki mevcut saatle karşılaştırdığınızda (örneğin, (new Date()).getTime() aracılığıyla) beklenmedik sonuçlar elde edebilirsiniz.

Çerçeve kimlikleri

Bir sekmedeki çerçeveler, çerçeve kimliğiyle tanımlanabilir. Ana çerçevenin çerçeve kimliği her zaman 0, alt çerçevelerin kimliği ise pozitif bir sayıdır. Bir doküman çerçeve içinde oluşturulduktan sonra çerçeve kimliği, dokümanın kullanım ömrü boyunca değişmez. Chrome 49'dan itibaren bu kimlik, çerçevenin ömrü boyunca (birden fazla gezinme işleminde) de sabittir.

Chrome'un çok işlemli yapısı nedeniyle bir sekme, web sayfasının kaynağını ve hedefini oluşturmak için farklı işlemler kullanabilir. Bu nedenle, yeni bir işlemde gezinme gerçekleşirse yeni gezinme işlenene kadar (yani yeni ana çerçeve için onCommitted etkinliği gönderilene kadar) hem yeni hem de eski sayfadan etkinlik alabilirsiniz. Diğer bir deyişle, aynı frameId ile birden fazla bekleyen webNavigation etkinlik dizisi olabilir. Diziler processId tuşuyla ayırt edilebilir.

Ayrıca, geçici yükleme sırasında işlemin birkaç kez değiştirilebileceğini unutmayın. Bu durum, yük farklı bir siteye yönlendirildiğinde meydana gelir. Bu durumda, son onCommitted etkinliğini alana kadar tekrarlanan onBeforeNavigate ve onErrorOccurred etkinliklerini alırsınız.

Uzantılarla ilgili sorunlu bir diğer kavram da çerçevenin yaşam döngüsüdür. Bir çerçeve, bir dokümana (işlenmiş bir URL ile ilişkilendirilmiş) ev sahipliği yapar. Belge (ör. gezinerek) değişebilir ancak frameId değişmez. Bu nedenle, belirli bir belgede olan bir şeyi yalnızca frameId'lerle ilişkilendirmek zordur. Doküman başına benzersiz bir tanımlayıcı olan documentId kavramını kullanıma sunuyoruz. Bir çerçevede gezinilip yeni bir doküman açıldığında tanımlayıcı değişir. Bu alan, sayfalar yaşam döngüsü durumlarını (önceden oluşturma/etkin/önbelleğe alınmış arasında) değiştirdiğinde aynı kaldığı için bu durumu belirlemek için yararlıdır.

Geçiş türleri ve niteleyiciler

webNavigation API'nin onCommitted etkinliğinde transitionType ve transitionQualifiers özelliği bulunur. Geçiş türü, tarayıcının bu URL'ye nasıl gittiğini açıklayan Geçmiş API'sinde kullanılanla aynıdır. Ayrıca, gezinmeyi daha ayrıntılı bir şekilde tanımlayan çeşitli geçiş niteleyicileri de döndürülebilir.

Aşağıdaki geçiş nitelikleri mevcuttur:

Geçiş koşuluAçıklama
"client_redirect"Gezinme sırasında sayfadaki JavaScript veya meta yenileme etiketlerinden kaynaklanan bir veya daha fazla yönlendirme gerçekleşti.
"server_redirect"Gezinme sırasında, sunucudan gönderilen HTTP üstbilgilerinden kaynaklanan bir veya daha fazla yönlendirme gerçekleşti.
"forward_back"Kullanıcı, gezinmeyi başlatmak için İleri veya Geri düğmesini kullandı.
"from_address_bar"Kullanıcı, gezinme işlemini adres çubuğundan (diğer adıyla çok amaçlı adres çubuğu) başlattıysa.

Örnekler

Bu API'yi denemek için chrome-extension-samples deposundan webNavigation API örneğini yükleyin.

Türler

TransitionQualifier

Chrome 44 ve sonraki sürümler

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 ve sonraki sürümler

Gezinmenin nedeni. Geçmiş API'sinde tanımlanan geçiş türleri kullanılır. Bunlar, history API'de tanımlanan geçiş türleriyle aynıdır. Tek fark, geriye dönük uyumluluk için "auto_toplevel" yerine "start_page" kullanılmasıdır.

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"oluşturuldu"

"start_page"

"form_submit"

"reload"

"anahtar kelime"

"keyword_generated"

Yöntemler

getAllFrames()

Promise 
chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
): Promise<object[] | undefined>

Belirli bir sekmenin tüm çerçeveleriyle ilgili bilgileri alır.

Parametreler

  • ayrıntılar

    nesne

    Tüm karelerin alınacağı sekme hakkında bilgiler.

    • tabId

      sayı

      Sekmenin kimliği.

  • callback

    işlev isteğe bağlı

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

    (details?: object[]) => void

    • ayrıntılar

      object[] isteğe bağlı

      Belirtilen sekmede bulunan çerçevelerin listesi. Belirtilen sekme kimliği geçersizse null.

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • errorOccurred

        boole

        Bu çerçevedeki son gezinme bir hatayla kesintiye uğradıysa (ör. onErrorOccurred etkinliği tetiklendiyse) doğru değerini döndürür.

      • frameId

        sayı

        Çerçevenin kimliği. 0, bunun ana çerçeve olduğunu gösterir. Pozitif bir değer ise alt çerçevenin kimliğini gösterir.

      • frameType

        FrameType

        Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Bu kare için oluşturucuyu çalıştıran işlemin kimliği.

      • url

        dize

        Şu anda bu çerçeveyle ilişkilendirilmiş URL.

İadeler

  • Promise<object[] | undefined>

    Chrome 93 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.

getFrame()

Promise 
chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
): Promise<object | undefined>

Belirtilen çerçeveyle ilgili bilgileri alır. Çerçeve, bir web sayfasının <iframe> veya <frame> öğesini ifade eder ve sekme kimliği ile çerçeve kimliğiyle tanımlanır.

Parametreler

  • ayrıntılar

    nesne

    Hakkında bilgi alınacak çerçeveyle ilgili bilgiler.

    • documentId

      dize isteğe bağlı

      Chrome 106 veya daha yeni bir sürüm

      Belgenin UUID'si. frameId ve/veya tabId sağlanırsa, sağlanan belge kimliğiyle bulunan belgeyle eşleşip eşleşmediği doğrulanır.

    • frameId

      number isteğe bağlı

      Belirtilen sekmedeki çerçevenin kimliği.

    • processId

      number isteğe bağlı

      Chrome 49'dan beri kullanımdan kaldırıldı

      Artık çerçeveler, sekme kimlikleri ve çerçeve kimlikleriyle benzersiz şekilde tanımlanıyor. İşlem kimliği artık gerekli olmadığından yoksayılıyor.

      Bu sekmenin oluşturucuyu çalıştıran işlemin kimliği.

    • tabId

      number isteğe bağlı

      Çerçevenin bulunduğu sekmenin kimliği.

  • callback

    işlev isteğe bağlı

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

    (details?: object) => void

    • ayrıntılar

      object isteğe bağlı

      İstenen çerçeveyle ilgili bilgiler. Belirtilen çerçeve kimliği ve/veya sekme kimliği geçersizse null.

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • errorOccurred

        boole

        Bu çerçevedeki son gezinme bir hatayla kesintiye uğradıysa (ör. onErrorOccurred etkinliği tetiklendiyse) doğru değerini döndürür.

      • frameType

        FrameType

        Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • url

        dize

        frameId ile tanımlanan çerçeve, belirtilen sekmede bir noktada mevcutsa çerçeveyle şu anda ilişkili URL. Bir URL'nin belirli bir frameId ile ilişkilendirilmiş olması, ilgili çerçevenin hâlâ mevcut olduğu anlamına gelmez.

İadeler

  • Promise<object | undefined>

    Chrome 93 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

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

Bir gezinme işlemi gerçekleşmek üzereyken tetiklenir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, belirli bir sekme ve işlem için benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Chrome 50'den beri kullanımdan kaldırıldı

        Sonuçta ortaya çıkan dokümanı oluşturacak işlem, onCommit'e kadar bilinmediğinden bu etkinlik için processId artık ayarlanmıyor.

        -1 değeri.

      • tabId

        sayı

        Gezinmenin gerçekleşeceği sekmenin kimliği.

      • timeStamp

        sayı

        Tarayıcının gezinmeye başlamak üzere olduğu zaman (dönemden bu yana geçen milisaniye cinsinden).

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

Bir gezinme işlemi onaylandığında tetiklenir. Doküman (ve resimler ve alt çerçeveler gibi referans verdiği kaynaklar) hâlâ indiriliyor olabilir ancak dokümanın en azından bir kısmı sunucudan alınmıştır ve tarayıcı yeni dokümana geçmeye karar vermiştir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Bu kare için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

        Gezinmenin gerçekleştiği sekmenin kimliği.

      • timeStamp

        sayı

        Gezinmenin epoch'tan bu yana milisaniye cinsinden kesinleştirildiği zaman.

      • transitionQualifiers

        TransitionQualifier[]

        Geçiş niteleyicilerinin listesi.

      • transitionType

        TransitionType

        Gezinmenin nedeni.

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

Başvurduğu kaynaklar da dahil olmak üzere bir belge tamamen yüklendiğinde ve başlatıldığında tetiklenir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Bu kare için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

        Gezinmenin gerçekleştiği sekmenin kimliği.

      • timeStamp

        sayı

        Belgenin yüklenmesinin tamamlandığı zaman (epoch'tan bu yana geçen milisaniye cinsinden).

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

Bir gezinmeye ev sahipliği yapmak için yeni bir pencere veya mevcut bir pencerede yeni bir sekme oluşturulduğunda tetiklenir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • sourceFrameId

        sayı

        Gezinmenin tetiklendiği, sourceTabId'ye sahip çerçevenin kimliği. 0, ana çerçeveyi gösterir.

      • sourceProcessId

        sayı

        Kaynak çerçeve için oluşturucuyu çalıştıran sürecin kimliği.

      • sourceTabId

        sayı

        Gezinmenin tetiklendiği sekmenin kimliği.

      • tabId

        sayı

        URL'nin açıldığı sekmenin kimliği

      • timeStamp

        sayı

        Tarayıcının yeni bir görünüm oluşturmak üzere olduğu zaman (epoch'tan bu yana geçen milisaniye cinsinden süre).

      • url

        dize

        Yeni pencerede açılacak URL.

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

Sayfanın DOM'u tamamen oluşturulduğunda tetiklenir ancak referans verilen kaynakların yüklenmesi tamamlanmamış olabilir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Bu kare için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

        Gezinmenin gerçekleştiği sekmenin kimliği.

      • timeStamp

        sayı

        Sayfanın DOM'unun tamamen oluşturulduğu zaman (epoch'tan beri geçen milisaniye cinsinden).

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

Bir hata oluştuğunda ve gezinme iptal edildiğinde tetiklenir. Bu durum, ağ hatası oluştuğunda veya kullanıcı gezinmeyi iptal ettiğinde meydana gelebilir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • hata

        dize

        Hata açıklaması

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Chrome 50'den beri kullanımdan kaldırıldı

        Bu etkinlik için artık processId ayarlanmıyor.

        -1 değeri.

      • tabId

        sayı

        Gezinmenin gerçekleştiği sekmenin kimliği.

      • timeStamp

        sayı

        Hatanın oluştuğu zaman (epoch'tan bu yana geçen milisaniye cinsinden süre).

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

Çerçevenin geçmişi yeni bir URL ile güncellendiğinde tetiklenir. Bu çerçeveyle ilgili gelecekteki tüm etkinliklerde güncellenen URL kullanılır.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Bu kare için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

        Gezinmenin gerçekleştiği sekmenin kimliği.

      • timeStamp

        sayı

        Gezinmenin epoch'tan bu yana milisaniye cinsinden kesinleştirildiği zaman.

      • transitionQualifiers

        TransitionQualifier[]

        Geçiş niteleyicilerinin listesi.

      • transitionType

        TransitionType

        Gezinmenin nedeni.

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

Bir karenin referans parçası güncellendiğinde tetiklenir. Bu çerçeveyle ilgili gelecekteki tüm etkinliklerde güncellenen URL kullanılır.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen dokümanın UUID'si.

      • Chrome 106 veya daha yeni bir sürüm

        Belgenin bulunduğu yaşam döngüsü.

      • frameId

        sayı

        0, gezinmenin sekme içeriği penceresinde gerçekleştiğini gösterir. Pozitif bir değer, gezinmenin bir alt çerçevede gerçekleştiğini gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.

      • Chrome 106 veya daha yeni bir sürüm

        Gezinmenin gerçekleştiği çerçevenin türü.

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 veya daha yeni bir sürüm

        Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler

        Üst çerçevenin kimliği veya ana çerçeve ise -1.

      • processId

        sayı

        Bu kare için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

        Gezinmenin gerçekleştiği sekmenin kimliği.

      • timeStamp

        sayı

        Gezinmenin epoch'tan bu yana milisaniye cinsinden kesinleştirildiği zaman.

      • transitionQualifiers

        TransitionQualifier[]

        Geçiş niteleyicilerinin listesi.

      • transitionType

        TransitionType

        Gezinmenin nedeni.

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

Sekmenin içeriği farklı bir sekmeyle (genellikle daha önce önceden oluşturulmuş) değiştirildiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (details: object) => void

    • ayrıntılar

      nesne

      • replacedTabId

        sayı

        Değiştirilen sekmenin kimliği.

      • tabId

        sayı

        Eski sekmenin yerini alan sekmenin kimliği.

      • timeStamp

        sayı

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