chrome.webNavigation

Açıklama

Yayındaki navigasyon isteklerinin durumu hakkında bildirim almak için chrome.webNavigation API'yi kullanın.

İzinler

webNavigation

Tüm chrome.webNavigation yöntem ve etkinlikleri "webNavigation" iznini beyan etmenizi gerektiriyor uzantı manifest'inde bulabilirsiniz. Ö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 herhangi bir hata, onErrorOccurred etkinliğiyle sonuçlanır. Belirli bir navigasyon, onErrorOccurred sonrasında tetiklenen başka bir etkinlik yok.

Bir gezinme karesi alt çerçeveler içeriyorsa onCommitted, alt çerçevelerden önce tetiklenir onBeforeNavigate; onCompleted ise tüm alt öğelerindeki onCompleted sonrasında tetiklenir.

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

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

Gezinme işlemi bir sayfayı Geri İleri Önbellekten geri yüklediyse onDOMContentLoaded etkinliği etkinleşmez. Sayfa açıldığında içeriğin yüklenmesi zaten tamamlandığından etkinlik tetiklenmez olduğunu fark etti.

Chrome Anında Arama veya Hızlı Sayfalar kullanılarak bir gezinme tetiklendiyse, tamamen yüklenmiş bir sayfası geçerli sekmeye değiştirildi. Bu durumda bir onTabReplaced etkinliği tetiklenir.

webRequest etkinlikleriyle ilişki

webRequest API'nin etkinlikleri ile webGezinme API'si. Çerçeveler için webRequest etkinliklerinin alınması mümkündür yoksa gezinmenin yalnızca ağ kaynakları zaten hazırlandıktan sonra devam ettiğini tam olarak yüklendi.

Genel olarak webGezinme etkinlikleri, görüntülenen gezinme durumuyla yakından ilgilidir. kullanıcı arayüzünde, webRequest etkinlikleri ise ağ yığınının kullanıcılar için opak hale gelir.

Sekme kimlikleri

Tüm gezinme sekmeleri, Chrome'un kullanıcı arayüzünde gerçek sekmelere karşılık gelmez. Örneğin, önceden işlendi. Sekmeler API'si kullanılarak bu tür sekmelere erişilemez ve siz bilgi isteğinde bulunamazsınız webNavigation.getFrame() veya webNavigation.getAllFrames() numaralı telefonu arayarak bunlarla ilgili daha fazla bilgi edinebilirsiniz. Böyle bir sekme değiştirilir, bir onTabReplaced etkinliği etkinleştirilir ve bu API'ler aracılığıyla erişilebilir hale gelir.

Zaman damgaları

İşletim sisteminin farklı Chrome'u işlemesi konusunda bazı teknik aksaklıkların yaşandığını belirtmek isteriz. işlemler, saatin tarayıcının kendisi ile uzantı işlemleri arasında sapmasına neden olabilir. O Bu, WebNavigation etkinliği timeStamp özelliğinin timeStamp özelliğinin yalnızca garanti edildiği anlamına gelir. dahili olarak tutarlı olması gerekir. Bir etkinliği başka bir etkinlikle karşılaştırmak doğru ofseti sağlar ancak bunları uzantının içindeki geçerli zamanla karşılaştırma ((new Date()).getTime() kullanarak, içeren) beklenmedik sonuçlar verebilir.

Çerçeve Kimlikleri

Bir sekmedeki çerçeveler bir kare kimliğiyle tanımlanabilir. Ana çerçevenin çerçeve kimliği her zaman 0'dır. Alt çerçevelerin kimliği pozitif bir sayıdır. Bir doküman çerçeve içinde oluşturulduktan sonra çerçeve kimliği süresi boyunca sabit kalır. Chrome 49'dan itibaren bu kimlik çerçevenin ömrü (birden fazla gezinmede).

Chrome'un çok işlemli yapısı nedeniyle bir sekme, kaynağı oluşturmak için farklı işlemler kullanabilir. ve hedefi gibi ayrıntılara yer verir. Bu nedenle, yeni bir süreçte gezinme gerçekleşirse Yeni gezinme tamamlanana kadar (yani Yeni ana çerçeve için onCommitted etkinliği gönderilir. Başka bir deyişle, aynı frameId değerine sahip, bekleyen bir webGezinme etkinliği dizisinden daha fazla. Diziler, processId anahtarıyla ayırt edilir.

Geçici yükleme sırasında işlemin birkaç kez değişebileceğini de unutmayın. Bu durum yapmanız gerektiğini unutmayın. Bu durumda, Son onCommitted etkinliğini elde edene kadar onBeforeNavigate ve onErrorOccurred etkinlikleri.

Uzantılarla ilgili sorun yaratan bir diğer kavram da çerçeve. Çerçeve, dokümanı (kayıtlı bir URL ile ilişkilendirilir) barındırır. Doküman değişebilir (örneğin, gezinerek) ancak frameId değişmediği için, belirli bir belgede meydana gelen olayların, bu belgede frameIds için de geçerli. Yeni bir documentId kavramını tanıtıyoruz. Bu, doküman başına benzersiz bir tanımlayıcıdır. Bir karede gezinilir ve bir kare açılırsa tanımlayıcının değişeceği yeni bir doküman görürsünüz. Bu alan, Çevik yaklaşımın Sayfalar yaşam döngüsü durumlarını değiştirdiğinde (önceden işleme/etkin/önbelleğe alınmış arasında) çünkü aynı kalıyor.

Geçiş türleri ve niteleyiciler

webNavigation onCommitted etkinliğinde transitionType ve transitionQualifiers var Geçiş türü, geçmiş API'sinde kullanılanla aynıdır. Bu tür tarayıcı bu URL'ye gitti. Ayrıca, çeşitli geçiş niteleyicileri de döndüren bir değer döndürür.

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

Geçiş niteleyiciAçıklama
"istemci_yönlendirmesi"Sayfadaki JavaScript veya meta yenileme etiketlerinin neden olduğu bir veya daha fazla yönlendirme gezinme sırasında gerçekleşti.
"sunucu_yönlendirmesi"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ı navigasyonu başlatmak için İleri veya Geri düğmesini kullanmıştır.
"from_address_bar"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 bölümünden webGezinme API'sı örneğini yükleyin. depodur.

Türler

TransitionQualifier

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Gezinmenin nedeni. History API'de tanımlanan geçiş türleri kullanılır. Bunlar, "auto_toplevel" yerine "start_page" kullanılması dışında (geriye dönük uyumluluk için) geçmiş API'sinde tanımlananlarla aynı geçiş türleridir.

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"oluşturuldu"

"start_page"

"form_submit"

"yeniden yükle"

"anahtar kelime"

"keyword_generate"

Yöntemler

getAllFrames()

Söz 'nı inceleyin.
chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
)

Belirli bir sekmedeki tüm çerçevelerle ilgili bilgileri alır.

Parametreler

  • ayrıntılar

    nesne

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

    • tabId

      sayı

      Sekmenin kimliği.

  • geri çağırma

    işlev isteğe bağlı

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

    (details?: object[]) => void

    • ayrıntılar

      nesne[] 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 'nı inceleyin.

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

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın bulunduğu yaşam döngüsü.

      • errorOccurred

        boolean

        Bu çerçevedeki son gezinme işlemi bir hata nedeniyle 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 belirtir; pozitif değer bir alt çerçevenin kimliğini gösterir.

      • frameType

        FrameType

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

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

İadeler

  • Promise<object[] | tanımlanmadı>

    Chrome 93 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.

getFrame()

Söz 'nı inceleyin.
chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
)

Belirli bir çerçeveyle ilgili bilgileri getirir. Çerçeve, bir <iframe> veya bir <frame> bir sekme kimliği ve çerçeve kimliğiyle tanımlanır.

Parametreler

  • ayrıntılar

    nesne

    Bilgi alınacak çerçeveyle ilgili bilgiler.

    • documentId

      dize isteğe bağlı

      Chrome 106 ve sonraki sürümler 'nı inceleyin.

      Dokümanın UUID'si. iFrameId ve/veya tabId sağlanmışsa bunların sağlanan doküman kimliğiyle bulunan dokümanla eşleştiği doğrulanır.

    • frameId

      sayı isteğe bağlı

      Belirtilen sekmedeki çerçevenin kimliği.

    • processId

      sayı isteğe bağlı

      Chrome 49'dan bu yana desteği sonlandırıldı

      Çerçeveler artık sekme kimlikleri ve çerçeve kimlikleriyle benzersiz biçimde tanımlanıyor; işlem kimliğine artık ihtiyaç duyulmaz ve bu nedenle yoksayılır.

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

    • tabId

      sayı isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

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

    (details?: object) => void

    • ayrıntılar

      nesne isteğe bağlı

      İstenen çerçeveyle ilgili bilgiler; belirtilen çerçeve kimliği ve/veya sekme kimliği geçersizse boştur.

      • documentId

        dize

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın bulunduğu yaşam döngüsü.

      • errorOccurred

        boolean

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

      • frameType

        FrameType

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

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

      • url

        dize

        frameId'nin tanımladığı çerçeve, belirtilen sekmenin bir noktasında mevcutsa şu anda bu çerçeveyle ilişkilendirilen URL. Bir URL'nin belirli bir frameId ile ilişkilendirilmiş olması, söz konusu çerçevenin hâlâ mevcut olduğu anlamına gelmez.

İadeler

  • Promise&lt;object | tanımlanmadı>

    Chrome 93 ve sonraki sürümler 'nı inceleyin.

    Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Çerçeve kimlikleri, belirli bir sekme ve işlem için benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

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

      • processId

        sayı

        Chrome 50'den bu yana desteği sonlandırıldı

        Elde edilen belgenin oluşturulacağı işlem onCommit tarihine kadar bilinmediğinden, transactionId artık bu etkinlik için ayarlanmıyor.

        -1 değeri.

      • tabId

        sayı

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

      • timeStamp

        sayı

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

      • url

        dize

  • filtreler

    nesne isteğe bağlı

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

onCommitted

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

Bir navigasyon kaydedildiğinde tetiklenir. Doküman (ve atıfta bulunduğ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 'nı inceleyin.

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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Sekme içinde çerçeve kimlikleri benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler 'nı inceleyin.

        Üst çerçevenin kimliği veya bu 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 gezinmenin kaydedildiği süre.

      • transitionQualifiers

        TransitionQualifier[]

        Geçiş niteleyicilerinin listesi.

      • transitionType

        TransitionType

        Gezinmenin nedeni.

      • url

        dize

  • filtreler

    nesne isteğe bağlı

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

onCompleted

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

Belirttiği kaynaklar 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 'nı inceleyin.

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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Sekme içinde çerçeve kimlikleri benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler 'nı inceleyin.

        Üst çerçevenin kimliği veya bu 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 dokümanın milisaniye cinsinden yüklenme süresi.

      • url

        dize

  • filtreler

    nesne isteğe bağlı

    • Ziyaret edilen URL'nin karşılaması gereken koşullar. "Şemalar" ve "bağlantı noktaları" UrlFilter 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 öğesini içeren ç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, dönemden bu yana geçen milisaniye cinsinden süre.

      • url

        dize

        Yeni pencerede açılacak URL.

  • filtreler

    nesne isteğe bağlı

    • Ziyaret edilen URL'nin karşılaması gereken koşullar. "Şemalar" ve "bağlantı noktaları" UrlFilter 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 referans verilen 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 'nı inceleyin.

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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Sekme içinde çerçeve kimlikleri benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler 'nı inceleyin.

        Üst çerçevenin kimliği veya bu 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, sayfanın DOM'sinin tam olarak oluşturulduğu süre.

      • url

        dize

  • filtreler

    nesne isteğe bağlı

    • Ziyaret edilen URL'nin karşılaması gereken koşullar. "Şemalar" ve "bağlantı noktaları" UrlFilter 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 'nı inceleyin.

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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Sekme içinde çerçeve kimlikleri benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler 'nı inceleyin.

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

      • processId

        sayı

        Chrome 50'den bu yana desteği sonlandırıldı

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

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

      • url

        dize

  • filtreler

    nesne isteğe bağlı

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

onHistoryStateUpdated

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

Çerçevenin geçmişi yeni bir URL olarak güncellendiğinde tetiklenir. Bu çerçevenin gelecekteki tüm etkinlikleri, 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 'nı inceleyin.

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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Sekme içinde çerçeve kimlikleri benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler 'nı inceleyin.

        Üst çerçevenin kimliği veya bu 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 gezinmenin kaydedildiği süre.

      • transitionQualifiers

        TransitionQualifier[]

        Geçiş niteleyicilerinin listesi.

      • transitionType

        TransitionType

        Gezinmenin nedeni.

      • url

        dize

  • filtreler

    nesne isteğe bağlı

    • Ziyaret edilen URL'nin karşılaması gereken koşullar. "Şemalar" ve "bağlantı noktaları" UrlFilter 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çevenin gelecekteki tüm etkinlikleri, 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 'nı inceleyin.

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

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

        Dokümanın 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, alt çerçevede gezinmeyi gösterir. Sekme içinde çerçeve kimlikleri benzersizdir.

      • Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentDocumentId

        dize isteğe bağlı

        Chrome 106 ve sonraki sürümler 'nı inceleyin.

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

      • parentFrameId

        sayı

        Chrome 74 ve sonraki sürümler 'nı inceleyin.

        Üst çerçevenin kimliği veya bu 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 gezinmenin kaydedildiği süre.

      • transitionQualifiers

        TransitionQualifier[]

        Geçiş niteleyicilerinin listesi.

      • transitionType

        TransitionType

        Gezinmenin nedeni.

      • url

        dize

  • filtreler

    nesne isteğe bağlı

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

onTabReplaced

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

Sekmenin içeriği farklı (genellikle önceden işlenmiş) 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ı

        Değişimin gerçekleştiği zaman (sıfırdan bu yana milisaniye cinsinden).