Açıklama
İşlem sırasındaki navigasyon isteklerinin durumu hakkında bildirim almak için chrome.webNavigation
API'yi kullanın.
İzinler
webNavigation
Tüm chrome.webNavigation
yöntemleri ve etkinlikleri, uzantı manifestinde "webNavigation"
iznini beyan etmenizi gerektirir. Örneğin:
{
"name": "My extension",
...
"permissions": [
"webNavigation"
],
...
}
Kavramlar ve kullanım
Etkinlik sırası
Başarıyla tamamlanan bir gezinme için etkinlikler aşağıdaki sırayla tetiklenir:
onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted
Süreç sırasında oluşan herhangi bir hata, onErrorOccurred
etkinliğine neden olur. Belirli bir navigasyon için onErrorOccurred
tarihinden sonra tetiklenen başka etkinlik bulunmaz.
Gezinme çerçevesi alt çerçeveler içeriyorsa onCommitted
alt çerçevelerinden herhangi birinden
onBeforeNavigate
önce, onCompleted
ise tüm alt çerçevelerinden onCompleted
sonra etkinleşir.
Bir çerçevenin referans parçası değiştirilirse onReferenceFragmentUpdated
etkinliği tetiklenir. Bu etkinlik onDOMContentLoaded
tarihinden sonra herhangi bir zamanda, hatta onCompleted
sonrasında bile tetiklenebilir.
Bir çerçevenin durumunu değiştirmek için geçmiş API'si kullanılırsa (ör. history.pushState()
kullanıldığında) bir onHistoryStateUpdated
etkinliği tetiklenir. Bu etkinlik, onDOMContentLoaded
tarihinden sonra herhangi bir zamanda tetiklenebilir.
Gezinme Geri İleri Önbelleği'nden bir sayfayı geri yüklediyse onDOMContentLoaded
etkinliği tetiklenmez. Sayfa ilk ziyaret edildiğinde içerik zaten yüklendiğinden etkinlik tetiklenmez.
Chrome Anında Arama veya Hızlı Sayfalar kullanılarak bir gezinme tetiklenirse tamamen yüklenmiş bir sayfa, mevcut sekmeyle değiştirilir. Bu durumda bir onTabReplaced
etkinliği tetiklenir.
webRequest etkinlikleriyle ilişki
webRequest API etkinlikleri ile web Navigation API etkinlikleri arasında tanımlı bir sıralama yoktur. Yeni bir gezinme başlatan kareler için webRequest etkinliklerinin alınmaya devam etmesi veya bir gezinmenin yalnızca ağ kaynakları tamamen yüklendikten sonra devam etmesi mümkündür.
Genel olarak web Navigation etkinlikleri, kullanıcı arayüzünde görüntülenen gezinme durumuyla yakından ilişkiliyken webRequest etkinlikleri, ağ yığınının genellikle kullanıcı için opak durumuna karşılık gelir.
Sekme Kimlikleri
Tüm gezinme sekmeleri, Chrome'un kullanıcı arayüzündeki gerçek sekmelere (ör. önceden oluşturulan bir sekme) karşılık gelmez. Bu tür sekmelere tabs API kullanılarak erişilemez. Ayrıca webNavigation.getFrame()
veya webNavigation.getAllFrames()
yöntemini çağırarak bu sekmeler hakkında bilgi isteyemezsiniz. Böyle bir sekme değiştirildiğinde, bir onTabReplaced
etkinliği tetiklenir ve etkinliklere bu API'ler üzerinden erişilebilir.
Zaman damgaları
İşletim sisteminin farklı Chrome işlemlerini işlemesiyle ilgili bazı teknik sorunların, saatin tarayıcının kendisi ile uzantı işlemleri arasında boğulmasına neden olabileceğini unutmamak önemlidir. Diğer bir deyişle, WebNavigation
etkinliği timeStamp
özelliğinin timeStamp
özelliğinin yalnızca dahili olarak tutarlı olacağı garanti edilir. Bir etkinliği başka bir etkinlikle karşılaştırmak, aralarındaki mesafeyi doğru şekilde sağlar. Ancak bunları uzantının içindeki geçerli zamanla karşılaştırmak (örneğin, (new Date()).getTime()
kullanarak) beklenmeyen sonuçlara yol açabilir.
Çerçeve kimlikleri
Bir sekme içindeki çerçeveler, bir çerçeve kimliğiyle tanımlanabilir. Ana çerçevenin kare kimliği her zaman 0'dır. Alt karelerin kimliği ise pozitif bir sayıdır. Bir belge çerçeve içinde oluşturulduktan sonra, çerçeve kimliği belgenin kullanım ömrü boyunca sabit kalır. Chrome 49 sürümünden itibaren bu kimlik, çerçevenin ömrü boyunca da (birden fazla gezinmede) sabittir.
Chrome'un çok işlemli yapısı nedeniyle, bir web sayfasının kaynağını ve hedefini oluşturmak için sekmelerde farklı işlemler kullanılabilir. Bu nedenle, gezinme yeni bir süreçte gerçekleşirse yeni gezinme kaydedilene (yani yeni ana çerçeve için onCommitted
etkinliği gönderilene) kadar hem yeni hem de eski sayfadan etkinlik alabilirsiniz. Diğer bir deyişle, aynı frameId
değerine sahip birden fazla bekleyen webGezinme etkinlikleri dizisi olabilir. Diziler, processId
anahtarıyla ayırt edilebilir.
Geçici yükleme sırasında işlemin birkaç kez değiştirilebileceğini de unutmayın. Bu, yükleme farklı bir siteye yönlendirildiğinde gerçekleşir. Bu durumda, son onCommitted
etkinliğini alana kadar tekrarlanan onBeforeNavigate
ve onErrorOccurred
etkinlikleri alırsınız.
Uzantılarla ilgili sorunlu olan bir başka kavram da çerçevenin yaşam döngüsüdür. Çerçeve, bir dokümanı barındırır (taahhüt edilen bir URL ile ilişkilendirilir). Doküman değişebilir (örneğin, gezinerek) ancak frameId değişmez. Bu nedenle, belirli bir dokümanda bir şeyin sadece frameIds ile ilişkilendirilmesi zordur. Her belge için benzersiz bir tanımlayıcı olan documentId kavramını kullanıma sunuyoruz. Bir çerçevede gezinilirse ve yeni bir doküman açılırsa tanımlayıcı değişir. Bu alan, aynı kaldığı için sayfaların yaşam döngüsü durumlarını ne zaman değiştireceğini (önceden oluşturma/etkin/önbelleğe alınmış arasında) belirlemek için kullanışlıdır.
Geçiş türleri ve niteleyiciler
webNavigation
onCommitted
etkinliğinin bir transitionType
ve transitionQualifiers
özelliği vardır. Geçiş türü, tarayıcının bu URL'ye nasıl gittiğini açıklayan geçmiş API'sinde kullanılanla aynıdır. Ayrıca, gezinmeyi daha iyi tanımlayan çeşitli geçiş niteleyicileri döndürülebilir.
Aşağıdaki geçiş niteleyicileri mevcuttur:
Geçiş niteleyici | Açıklama |
---|---|
"client_redirect" | Sayfadaki JavaScript veya meta yenileme etiketlerinin neden olduğu bir veya daha fazla yönlendirme, gezinme sırasında gerçekleşmiştir. |
"server_redirect" | Sunucudan gönderilen HTTP üstbilgilerinin neden olduğu bir veya daha fazla yönlendirme, gezinme sırasında gerçekleşti. |
"ileri_geri" | Kullanıcı, gezinmeyi başlatmak için İleri veya Geri düğmesini kullanmıştır. |
"gönderen_adres_çubuğu" | Kullanıcı, gezinmeyi adres çubuğundan (Çok amaçlı adres çubuğu) başlatmıştır. |
Örnekler
Bu API'yi denemek için chrome-extension-samples deposundan web Navigation API örneğini yükleyin.
Türler
TransitionQualifier
Enum
"client_redirect"
"server_redirect" (sunucu_yönlendirmesi)
"forward_back"
"from_address_bar"
TransitionType
Gezinme nedeni. Geçmiş API'sinde tanımlananlarla aynı geçiş türleri kullanılır. "auto_toplevel"
yerine "start_page"
bulunması (geriye dönük uyumluluk için) hariç olmak üzere, bunlar geçmiş API'sinde tanımlananlarla aynı geçiş türleridir.
Enum
"typed"
"auto_bookmark"
"auto_subframe"
"manual_subframe"
"start_page"
"form_submit"
Yöntemler
getAllFrames()
chrome.webNavigation.getAllFrames(
details: object,
callback?: function,
)
Belirli bir sekmenin tüm çerçeveleri hakkındaki bilgileri getirir.
Parametreler
-
ayrıntılar
nesne
Tüm karelerin alınacağı sekmeyle ilgili bilgiler.
-
tabId
sayı
Sekmenin kimliği.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(details?: object[]) => void
-
ayrıntılar
object[] isteğe bağlı
Belirtilen sekmedeki çerçevelerin listesi. Belirtilen sekme kimliği geçersizse boştur.
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
errorOccurred
boolean
Bu çerçevedeki son gezinme bir hata nedeniyle kesintiye uğradıysa (ör. onErrorOccurred etkinliği tetiklendiyse) doğru değerini alır.
-
frameId
sayı
Çerçevenin kimliği. 0 değeri bunun ana çerçeve olduğunu, pozitif değer ise alt çerçevenin kimliğini belirtir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Üst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Bu çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
url
dize
Şu anda bu çerçeveyle ilişkilendirilmiş olan URL.
-
-
İlerlemeler
-
Promise<object[] | undefined>
Chrome 93 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getFrame()
chrome.webNavigation.getFrame(
details: object,
callback?: function,
)
Belirli bir çerçeveyle ilgili bilgileri getirir. Çerçeve, bir web sayfasının <iframe> veya <frame> öğesi anlamına gelir ve sekme kimliği ve çerçeve kimliğiyle tanımlanır.
Parametreler
-
ayrıntılar
nesne
Hakkında bilgi alınacak çerçeveyle ilgili bilgiler.
-
documentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerDokümanın UUID'si. frameId ve/veya tabId sağlanmışsa bunlar, sağlanan doküman kimliği tarafından bulunan dokümanla eşleşecekleri şekilde doğrulanır.
-
frameId
numara isteğe bağlı
Belirtilen sekmedeki çerçevenin kimliği.
-
processId
numara isteğe bağlı
Chrome 49 sürümünden itibaren kullanımdan kaldırıldıÇerçeveler artık sekme kimlikleri ve çerçeve kimlikleri ile benzersiz şekilde tanımlanıyor. Artık işlem kimliğine ihtiyaç duyulmadığı için yok sayılır.
Bu sekme için oluşturucuyu çalıştıran işlemin kimliği.
-
tabId
numara isteğe bağlı
Çerçevenin içinde olduğu sekmenin kimliği.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(details?: object) => void
-
ayrıntılar
isteğe bağlı
İstenen çerçeveyle ilgili bilgiler. Belirtilen çerçeve kimliği ve/veya sekme kimliği geçersizse boş bırakılır.
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
errorOccurred
boolean
Bu çerçevedeki son gezinme bir hata nedeniyle kesintiye uğradıysa (ör. onErrorOccurred etkinliği tetiklendiyse) doğru değerini alır.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Üst çerçevenin kimliği veya ana çerçeveyse
-1
. -
url
dize
frameId tarafından tanımlanan çerçeve, belirtilen sekmenin bir noktasında bulunuyorsa şu anda bu çerçeveyle ilişkilendirilmiş olan URL. Bir URL'nin belirli bir frameId ile ilişkilendirilmesi, karşılık gelen çerçevenin hâlâ var olduğu anlamına gelmez.
-
-
İlerlemeler
-
Promise<object | undefined>
Chrome 93 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
Etkinlikler
onBeforeNavigate
chrome.webNavigation.onBeforeNavigate.addListener(
callback: function,
filters?: object,
)
Bir navigasyon gerçekleşmek üzereyken tetiklenir.
Parametreler
-
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
nesne
-
Chrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri, belirli bir sekme ve işlem için benzersizdir.
-
Chrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
sayı
Üst çerçevenin kimliği veya ana çerçeveyse
-1
. -
sayı
Chrome 50'den itibaren kullanımdan kaldırıldıSonuç belgesini oluşturacak işlem onCommit tarihine kadar bilinmediğinden, bu etkinlik için transactionId artık ayarlı değil.
-1 değeri.
-
sayı
Gezinmenin gerçekleştirileceği sekmenin kimliği.
-
sayı
Tarayıcının gezinmeyi başlatmak üzere olduğu, sıfır zamandan bu yana geçen milisaniye cinsinden süre.
-
dize
-
-
-
isteğe bağlı
-
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onCommitted
chrome.webNavigation.onCommitted.addListener(
callback: function,
filters?: object,
)
Bir gezinme kaydedildiğinde tetiklenir. Doküman (ve ilişkili olduğu resimler, alt çerçeveler gibi kaynaklar) hâlâ indiriliyor olabilir, ancak dokümanın en azından bir kısmı sunucudan alınmıştır ve tarayıcı yeni dokümana geçmeye karar vermiştir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
frameId
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Chrome 74 ve sonraki sürümlerÜst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Bu çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
tabId
sayı
Gezinmenin gerçekleştiği sekmenin kimliği.
-
timeStamp
sayı
Dönemden bu yana gezinmenin kaydedildiği süre (milisaniye cinsinden).
-
transitionQualifiers
Geçiş niteleyicilerinin listesi.
-
transitionType
Gezinme nedeni.
-
url
dize
-
-
-
filtreler
isteğe bağlı
-
url
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onCompleted
chrome.webNavigation.onCompleted.addListener(
callback: function,
filters?: object,
)
İlgili kaynaklar da dahil olmak üzere bir doküman tamamen yüklendiğinde ve başlatıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
frameId
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Chrome 74 ve sonraki sürümlerÜst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Bu çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
tabId
sayı
Gezinmenin gerçekleştiği sekmenin kimliği.
-
timeStamp
sayı
Dönemden bu yana, milisaniye cinsinden, dokümanın yüklenmesinin tamamlandığı süre.
-
url
dize
-
-
-
filtreler
isteğe bağlı
-
url
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onCreatedNavigationTarget
chrome.webNavigation.onCreatedNavigationTarget.addListener(
callback: function,
filters?: object,
)
Gezinmeyi barındırmak için yeni bir pencere veya mevcut bir pencerede yeni bir sekme oluşturulduğunda tetiklenir.
Parametreler
-
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
nesne
-
sayı
Gezinmenin tetiklendiği sourceTabId öğesine sahip çerçevenin kimliği. 0, ana çerçeveyi belirtir.
-
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, sıfır zamandan bu yana yeni bir görünüm oluşturmak üzere olduğu milisaniye cinsinden süre.
-
dize
Yeni pencerede açılacak URL.
-
-
-
isteğe bağlı
-
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onDOMContentLoaded
chrome.webNavigation.onDOMContentLoaded.addListener(
callback: function,
filters?: object,
)
Sayfanın DOM'si tam olarak oluşturulduğunda tetiklenir ancak başvurulan kaynakların yüklenmesi tamamlanmayabilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
frameId
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Chrome 74 ve sonraki sürümlerÜst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Bu çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
tabId
sayı
Gezinmenin gerçekleştiği sekmenin kimliği.
-
timeStamp
sayı
Sayfa DOM'sinin tamamen oluşturulduğu süre (sıfır zamandan bu yana milisaniye cinsinden).
-
url
dize
-
-
-
filtreler
isteğe bağlı
-
url
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onErrorOccurred
chrome.webNavigation.onErrorOccurred.addListener(
callback: function,
filters?: object,
)
Bir hata oluştuğunda ve gezinme iptal edildiğinde tetiklenir. Bu durum, bir ağ hatası oluştuysa veya kullanıcı gezinmeyi iptal ettiyse ortaya çıkabilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
hata
dize
Hata açıklaması.
-
frameId
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Chrome 74 ve sonraki sürümlerÜst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Chrome 50'den itibaren kullanımdan kaldırıldıBu etkinlik için transactionId artık ayarlı değil.
-1 değeri.
-
tabId
sayı
Gezinmenin gerçekleştiği sekmenin kimliği.
-
timeStamp
sayı
Dönemden bu yana, milisaniye cinsinden hatanın oluştuğu süre.
-
url
dize
-
-
-
filtreler
isteğe bağlı
-
url
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onHistoryStateUpdated
chrome.webNavigation.onHistoryStateUpdated.addListener(
callback: function,
filters?: object,
)
Kare geçmişi yeni bir URL ile güncellendiğinde tetiklenir. Bu çerçeveyle gelecekte yapılacak tüm etkinlikler güncellenen URL'yi kullanır.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
frameId
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Chrome 74 ve sonraki sürümlerÜst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Bu çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
tabId
sayı
Gezinmenin gerçekleştiği sekmenin kimliği.
-
timeStamp
sayı
Dönemden bu yana gezinmenin kaydedildiği süre (milisaniye cinsinden).
-
transitionQualifiers
Geçiş niteleyicilerinin listesi.
-
transitionType
Gezinme nedeni.
-
url
dize
-
-
-
filtreler
isteğe bağlı
-
url
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onReferenceFragmentUpdated
chrome.webNavigation.onReferenceFragmentUpdated.addListener(
callback: function,
filters?: object,
)
Bir çerçevenin referans parçası güncellendiğinde tetiklenir. Bu çerçeveyle gelecekte yapılacak tüm etkinlikler güncellenen URL'yi kullanır.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
documentId
dize
Chrome 106 ve sonraki sürümlerBelgenin UUID'si yüklendi.
-
documentLifecycleChrome 106 ve sonraki sürümler
Belgenin bulunduğu yaşam döngüsü.
-
frameId
sayı
0, gezinmenin sekme içeriği penceresinde yapıldığını, pozitif değer ise bir alt çerçevede gezinmeyi belirtir. Çerçeve kimlikleri bir sekme içinde benzersizdir.
-
frameTypeChrome 106 ve sonraki sürümler
Gezinmenin gerçekleştiği çerçevenin türü.
-
parentDocumentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerBu çerçevenin sahibi olan üst dokümanın UUID'si. Üst öğe yoksa bu ayar yapılmaz.
-
parentFrameId
sayı
Chrome 74 ve sonraki sürümlerÜst çerçevenin kimliği veya ana çerçeveyse
-1
. -
processId
sayı
Bu çerçeve için oluşturucuyu çalıştıran işlemin kimliği.
-
tabId
sayı
Gezinmenin gerçekleştiği sekmenin kimliği.
-
timeStamp
sayı
Dönemden bu yana gezinmenin kaydedildiği süre (milisaniye cinsinden).
-
transitionQualifiers
Geçiş niteleyicilerinin listesi.
-
transitionType
Gezinme nedeni.
-
url
dize
-
-
-
filtreler
isteğe bağlı
-
url
Gidilen URL'nin karşılaması gereken koşullar. UrlFilter'in "şemalar" ve "bağlantı noktaları" alanları bu etkinlik için yoksayılır.
-
onTabReplaced
chrome.webNavigation.onTabReplaced.addListener(
callback: function,
)
Sekmenin içeriği farklı bir (genellikle daha önce önceden oluşturulmuş) bir sekmeyle değiştirildiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(details: object) => void
-
ayrıntılar
nesne
-
replacedTabId
sayı
Değiştirilen sekmenin kimliği.
-
tabId
sayı
Eski sekmenin yerini alan sekmenin kimliği.
-
timeStamp
sayı
Dönemden bu yana, milisaniye cinsinden değiştirme işleminin gerçekleştiği süre.
-
-