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, bir dokümanı (kaydedilmiş 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ş niteleyici | Açı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
Enum
"client_redirect"
"server_redirect"
"forward_back"
"from_address_bar"
TransitionType
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()
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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()
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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<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
-
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
nesne
-
Chrome 106 ve sonraki sürümler 'nı inceleyin.
Dokümanın bulunduğu yaşam döngüsü.
-
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ü.
-
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.
-
sayı
Üst çerçevenin kimliği veya bu ana çerçeveyse
-1
. -
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.
-
sayı
Gezinmenin gerçekleşeceği sekmenin kimliği.
-
sayı
Tarayıcının gezinmeyi başlatmak üzere olduğu, dönemden bu yana geçen milisaniye cinsinden süre.
-
dize
-
-
-
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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
Geçiş niteleyicilerinin listesi.
-
transitionType
Gezinmenin nedeni.
-
url
dize
-
-
-
filtreler
nesne isteğe bağlı
-
url
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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ı
-
url
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
-
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
nesne
-
sayı
Gezinmenin tetiklendiği sourceTabId öğesini içeren çerçevenin kimliği. 0, ana çerçeveyi gösterir.
-
sayı
Kaynak çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
sayı
Gezinmenin tetiklendiği sekmenin kimliği.
-
sayı
URL'nin açıldığı sekmenin kimliği
-
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.
-
dize
Yeni pencerede açılacak URL.
-
-
-
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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ı
-
url
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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ı
-
url
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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
Geçiş niteleyicilerinin listesi.
-
transitionType
Gezinmenin nedeni.
-
url
dize
-
-
-
filtreler
nesne isteğe bağlı
-
url
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.
-
documentLifecycleChrome 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.
-
frameTypeChrome 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
Geçiş niteleyicilerinin listesi.
-
transitionType
Gezinmenin nedeni.
-
url
dize
-
-
-
filtreler
nesne isteğe bağlı
-
url
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).
-
-