chrome.webNavigation

Açıklama

Devam eden gezinme isteklerinin durumuyla ilgili bildirim almak için chrome.webNavigation API'sini 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 öğelerinden önce tetiklenir. onCompleted ise alt öğelerinin onCompleted öğelerinden 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 geçmiş API'si kullanılıyorsa (ör. history.pushState() kullanılarak) bir onHistoryStateUpdated etkinliği tetiklenir. Bu etkinlik, onDOMContentLoaded tarihinden sonra herhangi bir zamanda tetiklenebilir.

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

Gezinme Chrome Anında Arama veya Anında Sayfalar aracılığıyla 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 görünmeyen ağ yığınını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 Tabs API ü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 söz konusu API'ler aracılığıyla 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 (örneğin, (new Date()).getTime() aracılığıyla) karşılaştırdığınızda 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 sabit kalır. Chrome 49'dan itibaren bu kimlik, çerçeve ömrü boyunca (birden çok gezinme işleminde) da sabittir.

Chrome'un çoklu işlem 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 etkinlikler alabilirsiniz. Başka bir deyişle, aynı frameId ile birden fazla bekleyen webNavigation etkinlik dizisi olabilir. Diziler, processId anahtarıyla ayırt edilebilir.

Ayrıca, geçici yükleme sırasında işlemin birkaç kez değiştirilebileceğini de 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 değişebilir (ör. gezinerek) 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 açısından faydalı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 history API'de kullanılanla aynıdır. Ayrıca, gezinmeyi daha ayrıntılı tanımlayan çeşitli geçiş niteleyicileri de döndürülebilir.

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

Geçiş sıralama turuAçı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 başlıklarının neden olduğu 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. History API'de tanımlanan geçiş türleri kullanılır. Bunlar, History API'de tanımlanan geçiş türleriyle aynıdır. Aradaki 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"

"generated"

"start_page"

"form_submit"

"reload"

"keyword"

"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 çerçevelerin 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 sekmedeki çerçevelerin listesi. Belirtilen sekme kimliği geçersizse null.

      • documentId

        dize

        Chrome 106 veya daha yeni bir sürüm

        Yüklenen belgenin UUID'si.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 veya daha yeni bir sürüm

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

      • errorOccurred

        boolean

        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 çerçeve 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çeve hakkında bilgi. 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 belgenin UUID'si.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 veya daha yeni bir sürüm

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

      • errorOccurred

        boolean

        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 bu çerçeveyle şu anda ilişkilendirilmiş 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, pozitif bir değer ise alt çerçevede gezinme olduğunu gösterir. Frame 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 elde edilen dokümanı oluşturacak işlem, onCommit'e kadar bilinmediğinden bu etkinlik için artık processId 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. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.

onCommitted

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

Bir gezinme işlemi gerçekleştirildiğinde tetiklenir. Doküman (ve resimler ile 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 belgenin 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, pozitif bir değer ise alt çerçevede gezinme olduğunu 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 çerçeve için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

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

      • timeStamp

        sayı

        Gezinmenin gerçekleştirildiği zaman (epoch'tan beri geçen milisaniye cinsinden).

      • 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. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.

onCompleted

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

Başvurduğu kaynaklar da dahil olmak üzere bir doküman tamamen yüklenip 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 belgenin 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, pozitif bir değer ise alt çerçevede gezinme olduğunu 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 çerçeve 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 (dönemden bu yana geçen milisaniye cinsinden).

      • url

        dize

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için 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 (dönemden bu yana geçen milisaniye cinsinden).

      • url

        dize

        Yeni pencerede açılacak URL.

  • filtreler

    object isteğe bağlı

    • Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için 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 belgenin 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, pozitif bir değer ise alt çerçevede gezinme olduğunu 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 çerçeve 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. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için 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 belgenin 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, pozitif bir değer ise alt çerçevede gezinme olduğunu 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 (dönemden bu yana geçen milisaniye cinsinden).

      • url

        dize

  • filtreler

    object isteğe bağlı

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

onHistoryStateUpdated

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

Kare 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 belgenin 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, pozitif bir değer ise alt çerçevede gezinme olduğunu 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 çerçeve için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

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

      • timeStamp

        sayı

        Gezinmenin gerçekleştirildiği zaman (epoch'tan beri geçen milisaniye cinsinden).

      • 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. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için 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 belgenin 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, pozitif bir değer ise alt çerçevede gezinme olduğunu 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 çerçeve için oluşturucuyu çalıştıran işlemin kimliği.

      • tabId

        sayı

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

      • timeStamp

        sayı

        Gezinmenin gerçekleştirildiği zaman (epoch'tan beri geçen milisaniye cinsinden).

      • 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. UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için 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 (dönemden bu yana geçen milisaniye cinsinden).