Bu sayfa, Cloud Translation API ile çevrilmiştir.

chrome.webNavigation

Açıklama

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

İzinler

webNavigation

Tüm chrome.webNavigation yöntemleri ve etkinlikleri için "webNavigation" iznini uzantı manifestinde belirtmeniz gerekir. Ö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 gezinme için onErrorOccurred sonrasında başka etkinlik tetiklenmez.

Bir gezinme çerçevesi alt çerçeveler içeriyorsa onCommitted, alt öğelerinin onBeforeNavigate öğelerinden önce tetiklenir. onCompleted ise alt öğelerinin onCompleted öğelerinden sonra tetiklenir.

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

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

Bir gezinme, sayfayı geri-ileri önbellekten geri yüklediyse onDOMContentLoaded etkinliği tetiklenmez. Sayfa ilk ziyaret edildiğinde içerik yükleme işlemi tamamlanmış olduğu için etkinlik tetiklenmez.

Chrome Anında veya Anında Sayfalar kullanılarak bir gezinme tetiklendiyse tamamen yüklenmiş bir sayfa mevcut sekmede değiştirilir. Bu durumda, 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 gezinmeye başlamış olan çerçeveler için webRequest etkinliklerinin alınmaya devam etmesi veya gezinmenin yalnızca ağ kaynakları tamamen yüklendikten sonra devam etmesi mümkündür.

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

Sekme kimlikleri

Tüm gezinme sekmeleri, 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. Ayrıca webNavigation.getFrame() veya webNavigation.getAllFrames() numaralarını arayarak bu sekmeler hakkında bilgi isteyemezsiniz. Böyle bir sekme değiştirildiğinde onTabReplaced etkinliği tetiklenir ve bu sekmelere API'ler aracılığıyla erişilebilir.

Zaman damgaları

İşletim sisteminin farklı Chrome işlemlerini ele almasıyla ilgili bazı teknik tuhaflıkların, tarayıcı ile uzantı işlemleri arasında saatin yanlış gösterilmesine neden olabileceğini unutmayın. Bu, WebNavigation etkinliğinin timeStamp özelliğinin yalnızca dahili olarak tutarlı olacağının garanti edildiği anlamına gelir.timeStamp Bir etkinliği başka bir etkinlikle karşılaştırdığınızda aralarındaki doğru saat farkını elde edersiniz. Ancak bunları uzantıdaki mevcut saatle karşılaştırdığınızda (örneğin, (new Date()).getTime() kullanarak) beklenmedik sonuçlar elde edebilirsiniz.

Çerçeve kimlikleri

Bir sekmedeki çerçeveler, çerçeve kimliğiyle tanımlanabilir. Ana çerçevenin çerçeve kimliği her zaman 0, alt çerçevelerin kimliği ise pozitif bir sayıdır. Bir doküman çerçeve içinde 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 ömrü boyunca (birden fazla gezinme işleminde) de 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 işlenene kadar (yani yeni ana çerçeve için onCommitted etkinliği gönderilene kadar) hem yeni hem de eski sayfadan etkinlik alabilirsiniz. Başka bir deyişle, aynı frameId ile birden fazla bekleyen webNavigation etkinlik dizisi olabilir. Diziler, processId anahtarıyla ayırt edilebilir.

Ayrıca, geçici yükleme sırasında işlemin birkaç kez değiştirilebileceğini unutmayın. Bu durum, yük farklı bir siteye yönlendirildiğinde meydana gelir. Bu durumda, son onCommitted etkinliğini alana kadar tekrarlanan onBeforeNavigate ve onErrorOccurred etkinlikleri alırsınız.

Uzantılarla ilgili sorunlu olan bir diğer kavram da çerçevenin yaşam döngüsüdür. Bir çerçeve, bir dokümana (işlenmiş bir URL ile ilişkilendirilmiş) ev sahipliği yapar. Belge değişebilir (örneğin, gezinerek) ancak frameId değişmez. Bu nedenle, belirli bir belgede olan bir şeyi yalnızca frameId'lerle ilişkilendirmek zordur. Doküman başına benzersiz bir tanımlayıcı olan documentId kavramını kullanıma sunuyoruz. Bir çerçevede gezinilip yeni bir doküman açıldığında tanımlayıcı değişir. Bu alan, sayfaların yaşam döngüsü durumunu (önceden oluşturma/etkin/önbelleğe alınmış arasında) ne zaman değiştirdiğini belirlemek için kullanışlıdır. Çünkü bu alan aynı kalır.

Geçiş türleri ve niteleyiciler

webNavigation onCommitted etkinliğinde transitionType ve transitionQualifiers özelliği bulunur. Geçiş türü, tarayıcının bu belirli URL'ye nasıl gittiğini açıklayan history API'de kullanılanla aynıdır. Ayrıca, gezinmeyi daha ayrıntılı tanımlayan çeşitli geçiş niteleyicileri de döndürülebilir.

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

Geçiş sıralama turu	Açıklama
"client_redirect"	Gezinme sırasında sayfadaki JavaScript veya meta yenileme etiketlerinden kaynaklanan bir veya daha fazla yönlendirme gerçekleşti.
"server_redirect"	Gezinme sırasında, sunucudan gönderilen HTTP başlıklarının 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ı, gezinme işlemini adres çubuğundan (diğer adıyla çok amaçlı adres çubuğu) başlattıysa.

Örnekler

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

Türler

TransitionQualifier

Chrome 44 veya daha yeni bir sürüm

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome 44 veya daha yeni bir sürüm

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

Enum

"link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"generated"

"start_page"

"form_submit"

"reload"

"keyword"

"keyword_generated"

Yöntemler

getAllFrames()

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

Belirli bir sekmenin tüm çerçeveleriyle ilgili bilgileri alır.

Parametreler

ayrıntılar

nesne

Tüm karelerin alınacağı sekme hakkında bilgiler.
- tabId
  
  sayı
  
  Sekmenin kimliği.

İadeler

Promise<object[] | undefined>

Chrome 93 ve sonraki sürümler

getFrame()

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

Belirtilen çerçeveyle 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 çerçeveyle ilgili bilgiler.
- documentId
  
  dize isteğe bağlı
  
  Chrome 106 ve sonraki sürümler
  
  Belgenin UUID'si. frameId ve/veya tabId sağlanırsa, sağlanan belge kimliğiyle bulunan belgeyle eşleşip eşleşmediği doğrulanır.
- frameId
  
  number isteğe bağlı
  
  Belirtilen sekmedeki çerçevenin kimliği.
- processId
  
  number isteğe bağlı
  
  Chrome 49'dan beri kullanımdan kaldırıldı
  
  Artık çerçeveler, sekme kimlikleri ve çerçeve kimlikleriyle benzersiz şekilde tanımlanıyor. İşlem kimliği artık gerekli olmadığından yoksayılıyor.
  Bu sekmenin oluşturucuyu ç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

Etkinlikler

onBeforeNavigate

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

Bir gezinme işlemi 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
    
    Belgenin bulunduğu yaşam döngüsü.
  - frameId
    
    sayı
    
    0, gezinmenin sekme içeriği penceresinde gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Frame kimlikleri, belirli bir sekme ve işlem için benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Üst çerçevenin kimliği veya ana çerçeve ise -1.
  - processId
    
    sayı
    
    Chrome 50'den beri kullanımdan kaldırıldı
    
    Sonuçta elde edilen dokümanı oluşturacak işlem, onCommit'e kadar bilinmediğinden bu etkinlik için processId artık ayarlanmıyor.
    -1 değeri.
  - tabId
    
    sayı
    
    Gezinmenin gerçekleşeceği sekmenin kimliği.
  - timeStamp
    
    sayı
    
    Tarayıcının gezinmeye başlamak üzere olduğu zaman (dönemden bu yana geçen milisaniye cinsinden).
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onCommitted

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

Bir gezinme işlemi gerçekleştirildiğinde tetiklenir. Doküman (ve dokümanın referans verdiği kaynaklar, örneğin resimler ve alt çerçeveler) 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
    
    Yüklenen dokümanın UUID'si.
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    Chrome 106 ve sonraki sürümler
    
    Belgenin bulunduğu yaşam döngüsü.
  - frameId
    
    sayı
    
    0, gezinmenin sekme içeriği penceresinde gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Chrome 74 veya daha yeni bir sürüm
    
    Üst çerçevenin kimliği veya ana çerçeve ise -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ı
    
    Gezinmenin kaydedildiği zaman (epoch'tan beri geçen milisaniye cinsinden).
  - transitionQualifiers
    
    TransitionQualifier[]
    
    Geçiş niteleyicilerinin listesi.
  - transitionType
    
    TransitionType
    
    Gezinmenin nedeni.
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onCompleted

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

Başvurduğu kaynaklar da dahil olmak üzere bir doküman tamamen yüklenip 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
    
    Yüklenen dokümanın UUID'si.
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    Chrome 106 ve sonraki sürümler
    
    Belgenin bulunduğu yaşam döngüsü.
  - frameId
    
    sayı
    
    0, gezinmenin sekme içeriği penceresinde gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Chrome 74 veya daha yeni bir sürüm
    
    Üst çerçevenin kimliği veya ana çerçeve ise -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ı
    
    Belgenin yüklenmesinin tamamlandığı zaman (epoch'tan beri geçen milisaniye cinsinden).
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onCreatedNavigationTarget

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

Bir gezinmeye ev sahipliği yapmak 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'ye sahip çerçevenin kimliği. 0, ana çerçeveyi gösterir.
  - sourceProcessId
    
    sayı
    
    Kaynak çerçeve için oluşturucuyu çalıştıran sürecin 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 (dönem başlangıcından bu yana geçen milisaniye cinsinden).
  - url
    
    dize
    
    Yeni pencerede açılacak URL.
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onDOMContentLoaded

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

Sayfanın DOM'u tamamen oluşturulduğunda tetiklenir ancak referans verilen kaynakların yüklenmesi tamamlanmamış olabilir.

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(details: object) => void
```
- ayrıntılar
  
  nesne
  - documentId
    
    dize
    
    Chrome 106 ve sonraki sürümler
    
    Yüklenen dokümanın UUID'si.
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    Chrome 106 ve sonraki sürümler
    
    Belgenin bulunduğu yaşam döngüsü.
  - frameId
    
    sayı
    
    0, gezinmenin sekme içeriği penceresinde gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Chrome 74 veya daha yeni bir sürüm
    
    Üst çerçevenin kimliği veya ana çerçeve ise -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ı
    
    Sayfanın DOM'unun tamamen oluşturulduğu süre (epoch'tan beri geçen milisaniye).
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları 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, ağ hatası oluştuğunda veya kullanıcı gezinmeyi iptal ettiğinde meydana gelebilir.

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
    
    Yüklenen dokümanın UUID'si.
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    Chrome 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 gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Chrome 74 veya daha yeni bir sürüm
    
    Üst çerçevenin kimliği veya ana çerçeve ise -1.
  - processId
    
    sayı
    
    Chrome 50'den beri kullanımdan kaldırıldı
    
    Bu etkinlik için artık processId ayarlanmıyor.
    -1 değeri.
  - tabId
    
    sayı
    
    Gezinmenin gerçekleştiği sekmenin kimliği.
  - timeStamp
    
    sayı
    
    Hatayı oluştuğu zaman (dönemden bu yana geçen milisaniye cinsinden).
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları 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çeve için 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
    
    Yüklenen dokümanın UUID'si.
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    Chrome 106 ve sonraki sürümler
    
    Belgenin bulunduğu yaşam döngüsü.
  - frameId
    
    sayı
    
    0, gezinmenin sekme içeriği penceresinde gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Chrome 74 veya daha yeni bir sürüm
    
    Üst çerçevenin kimliği veya ana çerçeve ise -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ı
    
    Gezinmenin kaydedildiği zaman (epoch'tan beri geçen milisaniye cinsinden).
  - transitionQualifiers
    
    TransitionQualifier[]
    
    Geçiş niteleyicilerinin listesi.
  - transitionType
    
    TransitionType
    
    Gezinmenin nedeni.
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onReferenceFragmentUpdated

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

Bir karenin referans parçası güncellendiğinde tetiklenir. Bu çerçeve için 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
    
    Yüklenen dokümanın UUID'si.
  - documentLifecycle
    
    extensionTypes.DocumentLifecycle
    
    Chrome 106 ve sonraki sürümler
    
    Belgenin bulunduğu yaşam döngüsü.
  - frameId
    
    sayı
    
    0, gezinmenin sekme içeriği penceresinde gerçekleştiğini, pozitif bir değer ise bir alt çerçevede gezinme olduğunu gösterir. Çerçeve kimlikleri, bir sekmede benzersizdir.
  - frameType
    
    extensionTypes.FrameType
    
    Chrome 106 ve sonraki sürümler
    
    Geçişin gerçekleştiği çerçevenin türü.
  - parentDocumentId
    
    dize isteğe bağlı
    
    Chrome 106 ve sonraki sürümler
    
    Bu çerçeveye sahip üst dokümanın UUID'si. Üst öğe yoksa bu ayar belirlenmez.
  - parentFrameId
    
    sayı
    
    Chrome 74 veya daha yeni bir sürüm
    
    Üst çerçevenin kimliği veya ana çerçeve ise -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ı
    
    Gezinmenin kaydedildiği zaman (epoch'tan beri geçen milisaniye cinsinden).
  - transitionQualifiers
    
    TransitionQualifier[]
    
    Geçiş niteleyicilerinin listesi.
  - transitionType
    
    TransitionType
    
    Gezinmenin nedeni.
  - url
    
    dize
filtreler

object isteğe bağlı
- url
  
  events.UrlFilter[]
  
  Gidilen URL'nin karşılaması gereken koşullar. Bu etkinlik için UrlFilter'ın "şemalar" ve "bağlantı noktaları" alanları yoksayılır.

onTabReplaced

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

Sekmenin içeriği farklı bir sekmeyle (genellikle daha önce ö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ştirme işleminin gerçekleştiği zaman (dönemden bu yana geçen milisaniye cinsinden).

chrome.webNavigation Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Açıklama

İzinler

Kavramlar ve kullanım

Etkinlik sırası

webRequest etkinlikleriyle ilişkisi

Sekme kimlikleri

Zaman damgaları

Çerçeve kimlikleri

Geçiş türleri ve niteleyiciler

Örnekler

Türler

TransitionQualifier

Enum

TransitionType

Enum

Yöntemler

getAllFrames()

Parametreler

İadeler

getFrame()

Parametreler

İadeler

Etkinlikler

onBeforeNavigate

Parametreler

onCommitted

Parametreler

onCompleted

Parametreler

onCreatedNavigationTarget

Parametreler

onDOMContentLoaded

Parametreler

onErrorOccurred

Parametreler

onHistoryStateUpdated

Parametreler

onReferenceFragmentUpdated

Parametreler

onTabReplaced

Parametreler

chrome.webNavigation