browser.webNavigation

Açıklama

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

İzinler

webNavigation

Tüm browser.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

İş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 çerçevenin 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 Instant Pages kullanılarak tetiklendiyse tamamen yüklenmiş bir sayfa mevcut 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 hepsi Chrome'un kullanıcı arayüzündeki gerçek sekmelere karşılık gelmez. Örneğin, önceden oluşturulan bir sekme. Bu tür sekmelere tabs API kullanılarak erişilemez ve webNavigation.getFrame() veya webNavigation.getAllFrames() çağrılarak bu sekmeler hakkında bilgi istenemez. Bu tür bir sekme değiştirildiğinde onTabReplaced etkinliği tetiklenir ve bu API'ler aracılığıyla 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 etkinliğinin timeStamp özelliğinin 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ırdığınızda aralarındaki doğru farkı elde edersiniz ancak bunları uzantıdaki geçerli zamanla karşılaştırdığınızda (örneğin, (new Date()).getTime() kullanarak) beklenmedik sonuçlar elde edebilirsiniz.

Ç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. Belge değişebilir (ör. gezinme yoluyla) ancak frameId değişmez. Bu nedenle, belirli bir belgede 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 onCommitted etkinliğinin 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 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 ve sonraki sürümler Chrome 148'den itibaren browser.*

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

browser.webNavigation.getAllFrames(
  details: object,
): 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.

İadeler

• Promise<object[] | undefined>

  Chrome 93 ve sonraki sürümler Chrome 148'den itibaren browser.*

getFrame()

browser.webNavigation.getFrame(
  details: object,
): 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 ve sonraki sürümler Chrome 148'den itibaren browser.*

    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.

İadeler

• Promise<object | undefined>

  Chrome 93 ve sonraki sürümler Chrome 148'den itibaren browser.*

Etkinlikler

onBeforeNavigate

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Ü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

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Ü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

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

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Ü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

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Ü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

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Ü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

browser.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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • documentLifecycle

      extensionTypes.DocumentLifecycle

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

      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 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentDocumentId

      string isteğe bağlı

      Chrome 106 ve sonraki sürümler Chrome 148'den itibaren browser.*

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

    • parentFrameId

      sayı

      Chrome 74 ve sonraki sürümler Chrome 148'den itibaren browser.*

      Ü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

browser.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).