chrome.webNavigation

refresh date: 2026-09-25 robots: noindex

Açıklama

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

İzinler

webNavigation

Bu izin bir uyarı tetikler.

Manifest

Tüm chrome.webNavigation yöntemleri ve etkinlikleri için uzantı manifestinde "webNavigation" iznini beyan etmeniz 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 hatalar onErrorOccurred etkinliğiyle sonuçlanır. Belirli bir gezinme için onErrorOccurred sonrasında başka etkinlik tetiklenmez.

Gezinme çerçevesi alt çerçeveler içeriyorsa onCommitted, alt çerçevelerinden herhangi birinin onBeforeNavigate etkinliğinden önce tetiklenir. onCompleted ise tüm alt çerçevelerinin onCompleted etkinliğinden sonra tetiklenir.

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

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

Gezinme, bir sayfayı geri-ileri önbellekten geri yüklediyse onDOMContentLoaded etkinliği tetiklenmez. Sayfa ilk kez ziyaret edildiğinde içerik zaten yüklenmiş olduğundan etkinlik tetiklenmez.

Gezinme Chrome Anında Arama veya Anında Sayfalar aracılığıyla tetiklendiyse tamamen yüklenmiş bir sayfa geçerli sekmeye taşınır. Bu durumda bir 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 gezinme başlatan çerçeveler için webRequest etkinlikleri hâlâ alınabilir veya gezinme yalnızca ağ kaynakları tamamen yüklendikten sonra devam edebilir.

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österilmeyen ağ yığınının durumuna karşılık gelir.

Sekme kimlikleri

Gezinme sekmelerinin tümü 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 ve webNavigation.getFrame veya webNavigation.getAllFrames üzerinden bu sekmeler hakkında bilgi isteyemezsiniz. Bu tür bir sekme etkinleştirildiğinde bir onTabReplaced etkinliği tetiklenir ve bu API'ler üzerinden erişilebilir hale gelir.

Zaman damgaları

İşletim sisteminin farklı Chrome işlemlerini ele alma şeklindeki bazı teknik tuhaflıklar, tarayıcının kendisi ile uzantı işlemleri arasında saatin farklı olmasına neden olabilir. Bu, WebNavigation etkinliklerinin timeStamp özelliğinin yalnızca dahili olarak tutarlı olmasının garanti edildiği anlamına gelir. Bir etkinliği başka bir etkinlikle karşılaştırmak, aralarındaki doğru farkı verir ancak bunları uzantıdaki geçerli zamanla karşılaştırmak (ör. (new Date()).getTime() aracılığıyla) beklenmedik sonuçlar verebilir.

Çerçeve Kimlikleri

Sekmedeki çerçeveler, çerçeve kimliğiyle tanımlanabilir. Ana çerçevenin çerçeve kimliği her zaman 0'dır. Alt çerçevelerin kimliği ise pozitif bir sayıdır. Bir doküman bir çerçevede oluşturulduktan sonra çerçeve kimliği, dokümanın kullanım ömrü boyunca sabit kalır. Chrome 49'dan itibaren bu kimlik, çerçevenin kullanım ömrü boyunca (birden fazla gezinme işlemi arasında) 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 onaylanana kadar (yani yeni ana çerçeve için onCommitted etkinliği gönderilene kadar) hem yeni hem de eski sayfadan etkinlikler alabilirsiniz. Diğer bir deyişle, aynı frameId ile birden fazla bekleyen webNavigation etkinliği 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 durum, yük 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 bir diğer kavram da çerçevenin yaşam döngüsüdür. Bir çerçeve, bir dokümanı (onaylanmış bir URL ile ilişkili) barındırır. Doküman değişebilir (ör. gezinme yoluyla) ancak frameId değişmez. Bu nedenle, belirli bir dokümanda bir şey olduğunu yalnızca frameId'lerle ilişkilendirmek zordur. Her doküman için benzersiz bir tanımlayıcı olan documentId kavramını kullanıma sunuyoruz. Bir çerçeveye gidilip yeni bir doküman açılırsa tanımlayıcı değişir. Bu alan, sayfaların yaşam döngüsü durumunu (önceden işleme/etkin/önbelleğe alınmış arasında) ne zaman değiştirdiğini belirlemek için kullanışlı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ı tanımlayan çeşitli geçiş niteleyicileri döndürülebilir.

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

Geçiş sıralama turu	Açıklama
"client_redirect"	Gezinme sırasında sayfadaki JavaScript veya meta yenileme etiketlerinden kaynaklanan bir ya da daha fazla yönlendirme gerçekleşti.
"server_redirect"	Gezinme sırasında, sunucudan gönderilen HTTP üstbilgilerinin 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ı, gezinmeyi adres çubuğundan (çok amaçlı adres çubuğu olarak da bilinir) başlattı.

Örnekler

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

Türler

TransitionQualifier

Chrome 44+

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44+

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, "auto_toplevel" yerine "start_page" kullanılmasıdır (geriye dönük uyumluluk için).

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"üretildi"

"start_page"

"form_submit"

"reload"

"anahtar kelime"

"keyword_generated"

Yöntemler

getAllFrames()

Taahhüt

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

Belirli bir sekmenin tüm kareleri hakkında bilgi alır.

Parametreler

• ayrıntılar

  nesne

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

  • tabId

    sayı

    Sekmenin kimliği.

• callback

  function 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 karelerin listesi. Belirtilen sekme kimliği geçersizse null değerini döndürür.

    • documentId

      dize

      Chrome 106+

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

    • documentLifecycle

      DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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 alır.

    • frameId

      sayı

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

    • frameType

      FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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şkili olan URL.

İadeler

• Promise<object[] | undefined>

  Chrome 93 ve sonraki sürümler

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

getFrame()

Taahhüt

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

Belirli bir kareyle 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 kareyle ilgili bilgiler.

  • documentId

    string isteğe bağlı

    Chrome 106+

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

  • frameId

    number isteğe bağlı

    Belirtilen sekmedeki çerçevenin kimliği.

  • processId

    number isteğe bağlı

    Chrome 49'dan itibaren desteği sonlandırıldı

    Kareler artık sekme kimlikleri ve kare kimlikleriyle benzersiz şekilde tanımlanır. İşlem kimliğine artık gerek yoktur ve bu nedenle yoksayılır.

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

  • tabId

    number isteğe bağlı

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

• callback

  function isteğe bağlı

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

  (details?: object) => void

  • ayrıntılar

    isteğe bağlı nesne

    İstenen çerçeveyle ilgili bilgiler. Belirtilen çerçeve kimliği ve/veya sekme kimliği geçersizse null değeri döndürülür.

    • documentId

      dize

      Chrome 106+

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

    • documentLifecycle

      DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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 alır.

    • frameType

      FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • parentFrameId

      sayı

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

    • url

      dize

      frameId ile tanımlanan çerçeve, belirli bir sekmede bir noktada mevcutsa şu anda bu çerçeveyle 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

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

Etkinlikler

onBeforeNavigate

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

Bir gezinme gerçekleşmek üzereyken tetiklenir.

Parametreler

• callback

  işlev

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

  (details: object) => void

  • ayrıntılar

    nesne

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri, belirli bir sekme ve işlem için benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • parentFrameId

      sayı

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

    • processId

      sayı

      Chrome 50'den itibaren desteği sonlandırıldı

      Sonuç dokümanını oluşturacak işlem onCommit'e kadar bilinmediğinden, processId artık bu etkinlik için ayarlanmaz.

      -1 değeri.

    • tabId

      sayı

      Gezinmenin gerçekleşmek üzere olduğu sekmenin kimliği.

    • timeStamp

      sayı

      Tarayıcının gezinmeye başlamak üzere olduğu zaman (başlangıçtan itibaren milisaniye cinsinden).

    • url

      dize

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

onCommitted

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

Bir gezinme işlemi tamamlandığında 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+

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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 onaylandığı zaman (epoch'tan itibaren milisaniye cinsinden).

    • transitionQualifiers

      TransitionQualifier[]

      Geçiş niteleyicilerinin listesi.

    • transitionType

      TransitionType

      Gezinmenin nedeni.

    • url

      dize

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

onCompleted

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

Bir doküman, referans verdiği kaynaklar da dahil olmak üzere 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+

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

onCreatedNavigationTarget

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

Bir gezinmeyi barındırmak 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 değerine sahip çerçevenin kimliği. 0, ana çerçeveyi gösterir.

    • 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 yeni bir görünüm oluşturmak üzere olduğu zaman (epoch'tan itibaren milisaniye cinsinden).

    • url

      dize

      Yeni pencerede açılacak URL.

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

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+

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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 itibaren milisaniye cinsinden).

    • url

      dize

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

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ştuğunda veya kullanıcı gezinmeyi iptal ettiğinde ortaya çıkabilir.

Parametreler

• callback

  işlev

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

  (details: object) => void

  • ayrıntılar

    nesne

    • documentId

      dize

      Chrome 106+

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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 itibaren desteği sonlandırıldı

      processId artık bu etkinlik için 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).

    • url

      dize

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

onHistoryStateUpdated

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

Çerçevenin geçmişi yeni bir URL'ye güncellendiğinde tetiklenir. Bu kareyle 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+

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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 onaylandığı zaman (epoch'tan itibaren milisaniye cinsinden).

    • transitionQualifiers

      TransitionQualifier[]

      Geçiş niteleyicilerinin listesi.

    • transitionType

      TransitionType

      Gezinmenin nedeni.

    • url

      dize

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

onReferenceFragmentUpdated

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

Bir karenin referans parçası güncellendiğinde tetiklenir. Bu kareyle 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+

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106+

      Belgenin içinde 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, bir alt çerçevede gezinmeyi gösterir. Kare kimlikleri bir sekme içinde benzersizdir.

    • frameType

      extensionTypes.FrameType

      Chrome 106+

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106+

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

    • 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 onaylandığı zaman (epoch'tan itibaren milisaniye cinsinden).

    • transitionQualifiers

      TransitionQualifier[]

      Geçiş niteleyicilerinin listesi.

    • transitionType

      TransitionType

      Gezinmenin nedeni.

    • url

      dize

• filtreler

  isteğe bağlı nesne

  • url

    events.UrlFilter[]

    Gidilen URL'nin karşılaması gereken koşullar.

onTabReplaced

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

Sekmenin içeriği farklı bir sekmeyle (genellikle ö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şikliğin gerçekleştiği zaman (epoch'tan bu yana geçen milisaniye cinsinden).