chrome.webNavigation

Açıklama

İşlem sırasındaki navigasyon isteklerinin durumu hakkında bildirim almak için chrome.webNavigation API'yi kullanın.

İzinler

webNavigation

Tüm chrome.webNavigation yöntemleri ve etkinlikleri, uzantı manifestinde "webNavigation" iznini beyan etmenizi gerektirir. Örneğin:

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

Kavramlar ve kullanım

Etkinlik sırası

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

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

Süreç sırasında oluşan herhangi bir hata, onErrorOccurred etkinliğine neden olur. Belirli bir navigasyon için onErrorOccurred tarihinden sonra tetiklenen başka etkinlik bulunmaz.

Gezinme çerçevesi alt çerçeveler içeriyorsa onCommitted alt çerçevelerinden herhangi birinden onBeforeNavigate önce, onCompleted ise tüm alt çerçevelerinden onCompleted sonra etkinleşir.

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

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

Gezinme Geri İleri Önbelleği'nden bir sayfayı geri yüklediyse onDOMContentLoaded etkinliği tetiklenmez. Sayfa ilk ziyaret edildiğinde içerik zaten yüklendiğinden etkinlik tetiklenmez.

Chrome Anında Arama veya Hızlı Sayfalar kullanılarak bir gezinme tetiklenirse tamamen yüklenmiş bir sayfa, mevcut sekmeyle değiştirilir. Bu durumda bir onTabReplaced etkinliği tetiklenir.

webRequest etkinlikleriyle ilişki

webRequest API etkinlikleri ile web Navigation API etkinlikleri arasında tanımlı bir sıralama yoktur. Yeni bir gezinme başlatan kareler için webRequest etkinliklerinin alınmaya devam etmesi veya bir gezinmenin yalnızca ağ kaynakları tamamen yüklendikten sonra devam etmesi mümkündür.

Genel olarak web Navigation etkinlikleri, kullanıcı arayüzünde görüntülenen gezinme durumuyla yakından ilişkiliyken webRequest etkinlikleri, ağ yığınının genellikle kullanıcı için opak durumuna karşılık gelir.

Sekme Kimlikleri

Tüm gezinme sekmeleri, Chrome'un kullanıcı arayüzündeki gerçek sekmelere (ör. önceden oluşturulan bir sekme) karşılık gelmez. Bu tür sekmelere tabs API kullanılarak erişilemez. Ayrıca webNavigation.getFrame() veya webNavigation.getAllFrames() yöntemini çağırarak bu sekmeler hakkında bilgi isteyemezsiniz. Böyle bir sekme değiştirildiğinde, bir onTabReplaced etkinliği tetiklenir ve etkinliklere bu API'ler üzerinden erişilebilir.

Zaman damgaları

İşletim sisteminin farklı Chrome işlemlerini işlemesiyle ilgili bazı teknik sorunların, saatin tarayıcının kendisi ile uzantı işlemleri arasında boğulmasına neden olabileceğini unutmamak önemlidir. Diğer bir deyişle, WebNavigation etkinliği timeStamp özelliğinin timeStamp özelliğinin yalnızca dahili olarak tutarlı olacağı garanti edilir. Bir etkinliği başka bir etkinlikle karşılaştırmak, aralarındaki mesafeyi doğru şekilde sağlar. Ancak bunları uzantının içindeki geçerli zamanla karşılaştırmak (örneğin, (new Date()).getTime() kullanarak) beklenmeyen sonuçlara yol açabilir.

Çerçeve kimlikleri

Bir sekme içindeki çerçeveler, bir çerçeve kimliğiyle tanımlanabilir. Ana çerçevenin kare kimliği her zaman 0'dır. Alt karelerin kimliği ise pozitif bir sayıdır. Bir belge çerçeve içinde oluşturulduktan sonra, çerçeve kimliği belgenin kullanım ömrü boyunca sabit kalır. Chrome 49 sürümünden itibaren bu kimlik, çerçevenin ömrü boyunca da (birden fazla gezinmede) sabittir.

Chrome'un çok işlemli yapısı nedeniyle, bir web sayfasının kaynağını ve hedefini oluşturmak için sekmelerde farklı işlemler kullanılabilir. Bu nedenle, gezinme yeni bir süreçte gerçekleşirse yeni gezinme kaydedilene (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 değerine sahip birden fazla bekleyen webGezinme etkinlikleri dizisi olabilir. Diziler, processId anahtarıyla ayırt edilebilir.

Geçici yükleme sırasında işlemin birkaç kez değiştirilebileceğini de unutmayın. Bu, yükleme farklı bir siteye yönlendirildiğinde gerçekleşir. Bu durumda, son onCommitted etkinliğini alana kadar tekrarlanan onBeforeNavigate ve onErrorOccurred etkinlikleri alırsınız.

Uzantılarla ilgili sorunlu olan bir başka kavram da çerçevenin yaşam döngüsüdür. Çerçeve, bir dokümanı barındırır (taahhüt edilen bir URL ile ilişkilendirilir). Doküman değişebilir (örneğin, gezinerek) ancak frameId değişmez. Bu nedenle, belirli bir dokümanda bir şeyin sadece frameIds ile ilişkilendirilmesi zordur. Her belge için benzersiz bir tanımlayıcı olan documentId kavramını kullanıma sunuyoruz. Bir çerçevede gezinilirse ve yeni bir doküman açılırsa tanımlayıcı değişir. Bu alan, aynı kaldığı için sayfaların yaşam döngüsü durumlarını ne zaman değiştireceğini (önceden oluşturma/etkin/önbelleğe alınmış arasında) belirlemek için kullanışlıdır.

Geçiş türleri ve niteleyiciler

webNavigation onCommitted etkinliğinin bir transitionType ve transitionQualifiers özelliği vardır. 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 iyi tanımlayan çeşitli geçiş niteleyicileri döndürülebilir.

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

Geçiş niteleyici	Açıklama
"client_redirect"	Sayfadaki JavaScript veya meta yenileme etiketlerinin neden olduğu bir veya daha fazla yönlendirme, gezinme sırasında gerçekleşmiştir.
"server_redirect"	Sunucudan gönderilen HTTP üstbilgilerinin neden olduğu bir veya daha fazla yönlendirme, gezinme sırasında gerçekleşti.
"ileri_geri"	Kullanıcı, gezinmeyi başlatmak için İleri veya Geri düğmesini kullanmıştır.
"gönderen_adres_çubuğu"	Kullanıcı, gezinmeyi adres çubuğundan (Çok amaçlı adres çubuğu) başlatmıştır.

Örnekler

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

Türler

TransitionQualifier

Chrome 44 ve sonraki sürümler

Enum

"client_redirect"

"server_redirect" (sunucu_yönlendirmesi)

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 ve sonraki sürümler

Gezinme nedeni. Geçmiş API'sinde tanımlananlarla aynı geçiş türleri kullanılır. "auto_toplevel" yerine "start_page" bulunması (geriye dönük uyumluluk için) hariç olmak üzere, bunlar geçmiş API'sinde tanımlananlarla aynı geçiş türleridir.

Enum

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"start_page"

"form_submit"

Yöntemler

getAllFrames()

Söz

chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
)

Belirli bir sekmenin tüm çerçeveleri hakkındaki bilgileri getirir.

Parametreler

• ayrıntılar

  nesne

  Tüm karelerin alınacağı sekmeyle ilgili bilgiler.

  • tabId

    sayı

    Sekmenin kimliği.

• geri çağırma

  Functions (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 boştur.

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • errorOccurred

      boolean

      Bu çerçevedeki son gezinme bir hata nedeniyle kesintiye uğradıysa (ör. onErrorOccurred etkinliği tetiklendiyse) doğru değerini alır.

    • frameId

      sayı

      Çerçevenin kimliği. 0 değeri bunun ana çerçeve olduğunu, pozitif değer ise alt çerçevenin kimliğini belirtir.

    • frameType

      FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Üst çerçevenin kimliği veya ana çerçeveyse -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ş olan URL.

İlerlemeler

• Promise<object[]|undefined>

  Chrome 93 ve sonraki sürümler

  Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getFrame()

Söz

chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
)

Belirli bir çerçeveyle ilgili bilgileri getirir. Çerçeve, bir web sayfasının <iframe> veya <frame> öğesi anlamına gelir ve sekme kimliği ve çerçeve kimliğiyle tanımlanır.

Parametreler

• ayrıntılar

  nesne

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

  • documentId

    string isteğe bağlı

    Chrome 106 ve sonraki sürümler

    Dokümanın UUID'si. frameId ve/veya tabId sağlanmışsa bunlar, sağlanan doküman kimliği tarafından bulunan dokümanla eşleşecekleri şekilde doğrulanır.

  • frameId

    numara isteğe bağlı

    Belirtilen sekmedeki çerçevenin kimliği.

  • processId

    numara isteğe bağlı

    Chrome 49 sürümünden itibaren kullanımdan kaldırıldı

    Çerçeveler artık sekme kimlikleri ve çerçeve kimlikleri ile benzersiz şekilde tanımlanıyor. Artık işlem kimliğine ihtiyaç duyulmadığı için yok sayılır.

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

  • tabId

    numara isteğe bağlı

    Çerçevenin içinde olduğu sekmenin kimliği.

• geri çağırma

  Functions (isteğe bağlı)

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

  (details?: object)=>void

  • ayrıntılar

    isteğe bağlı

    İstenen çerçeveyle ilgili bilgiler. Belirtilen çerçeve kimliği ve/veya sekme kimliği geçersizse boş bırakılır.

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • errorOccurred

      boolean

      Bu çerçevedeki son gezinme bir hata nedeniyle kesintiye uğradıysa (ör. onErrorOccurred etkinliği tetiklendiyse) doğru değerini alır.

    • frameType

      FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

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

    • url

      dize

      frameId tarafından tanımlanan çerçeve, belirtilen sekmenin bir noktasında bulunuyorsa şu anda bu çerçeveyle ilişkilendirilmiş olan URL. Bir URL'nin belirli bir frameId ile ilişkilendirilmesi, karşılık gelen çerçevenin hâlâ var olduğu anlamına gelmez.

İlerlemeler

• Promise<object|undefined>

  Chrome 93 ve sonraki sürümler

  Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onBeforeNavigate

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

Bir navigasyon gerçekleşmek üzereyken tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri, belirli bir sekme ve işlem için benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

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

    • processId

      sayı

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

      Sonuç belgesini oluşturacak işlem onCommit tarihine kadar bilinmediğinden, bu etkinlik için transactionId artık ayarlı değil.

      -1 değeri.

    • tabId

      sayı

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

    • timeStamp

      sayı

      Tarayıcının gezinmeyi başlatmak üzere olduğu, sıfır zamandan bu yana geçen milisaniye cinsinden süre.

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

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

onCommitted

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

Bir gezinme kaydedildiğinde tetiklenir. Doküman (ve ilişkili olduğu resimler, alt çerçeveler gibi 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

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler

      Üst çerçevenin kimliği veya ana çerçeveyse -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ı

      Dönemden bu yana gezinmenin kaydedildiği süre (milisaniye cinsinden).

    • transitionQualifiers

      TransitionQualifier[]

      Geçiş niteleyicilerinin listesi.

    • transitionType

      TransitionType

      Gezinme nedeni.

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

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

onCompleted

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

İlgili kaynaklar da dahil olmak üzere bir doküman tamamen yüklendiğinde ve başlatıldığında tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler

      Üst çerçevenin kimliği veya ana çerçeveyse -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ı

      Dönemden bu yana, milisaniye cinsinden, dokümanın yüklenmesinin tamamlandığı süre.

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

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

onCreatedNavigationTarget

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

Gezinmeyi barındırmak için yeni bir pencere veya mevcut bir pencerede yeni bir sekme oluşturulduğunda tetiklenir.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • sourceFrameId

      sayı

      Gezinmenin tetiklendiği sourceTabId öğesine sahip çerçevenin kimliği. 0, ana çerçeveyi belirtir.

    • sourceProcessId

      sayı

      Kaynak çerçeve için oluşturucuyu çalıştıran işlemin 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, sıfır zamandan bu yana yeni bir görünüm oluşturmak üzere olduğu milisaniye cinsinden süre.

    • url

      dize

      Yeni pencerede açılacak URL.

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "ş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'si tam olarak oluşturulduğunda tetiklenir ancak başvurulan kaynakların yüklenmesi tamamlanmayabilir.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler

      Üst çerçevenin kimliği veya ana çerçeveyse -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ı

      Sayfa DOM'sinin tamamen oluşturulduğu süre (sıfır zamandan bu yana milisaniye cinsinden).

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "ş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, bir ağ hatası oluştuysa veya kullanıcı gezinmeyi iptal ettiyse ortaya çıkabilir.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • hata

      dize

      Hata açıklaması.

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler

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

    • processId

      sayı

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

      Bu etkinlik için transactionId artık ayarlı değil.

      -1 değeri.

    • tabId

      sayı

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

    • timeStamp

      sayı

      Dönemden bu yana, milisaniye cinsinden hatanın oluştuğu süre.

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "ş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 gelecekte yapılacak tüm etkinlikler güncellenen URL'yi kullanır.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler

      Üst çerçevenin kimliği veya ana çerçeveyse -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ı

      Dönemden bu yana gezinmenin kaydedildiği süre (milisaniye cinsinden).

    • transitionQualifiers

      TransitionQualifier[]

      Geçiş niteleyicilerinin listesi.

    • transitionType

      TransitionType

      Gezinme nedeni.

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

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

onReferenceFragmentUpdated

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

Bir çerçevenin referans parçası güncellendiğinde tetiklenir. Bu çerçeveyle gelecekte yapılacak tüm etkinlikler güncellenen URL'yi kullanır.

Parametreler

• geri çağırma

  işlev

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

  (details: object)=>void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106 ve sonraki sürümler

      Belgenin UUID'si yüklendi.

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler

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

    • frameId

      sayı

      0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106 ve sonraki sürümler

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Bu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler

      Üst çerçevenin kimliği veya ana çerçeveyse -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ı

      Dönemden bu yana gezinmenin kaydedildiği süre (milisaniye cinsinden).

    • transitionQualifiers

      TransitionQualifier[]

      Geçiş niteleyicilerinin listesi.

    • transitionType

      TransitionType

      Gezinme nedeni.

    • url

      dize

• filtreler

  isteğe bağlı

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "ş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 (genellikle daha önce önceden oluşturulmuş) bir sekmeyle değiştirildiğinde tetiklenir.

Parametreler

• geri çağırma

  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ı

      Dönemden bu yana, milisaniye cinsinden değiştirme işleminin gerçekleştiği süre.