browser.devtools.network

Açıklama

Geliştirici Araçları tarafından Ağ panelinde gösterilen ağ istekleriyle ilgili bilgileri almak için chrome.devtools.network API'yi kullanın.

Ağ istekleri bilgileri, HTTP Arşivi biçiminde (HAR) gösterilir. HAR açıklaması bu belgenin kapsamı dışındadır. HAR v1.2 Spesifikasyonu'na bakın.

HAR açısından, browser.devtools.network.getHAR() yöntemi HAR günlüğünün tamamını döndürürken browser.devtools.network.onRequestFinished etkinliği, etkinlik geri çağırma işlevine bağımsız değişken olarak HAR girişi sağlar.

Verimlilik nedeniyle istek içeriğinin HAR kapsamında sağlanmadığını unutmayın. İçeriği almak için isteğin getContent() yöntemini çağırabilirsiniz.

Geliştirici Araçları penceresi sayfa yüklendikten sonra açılırsa getHAR() tarafından döndürülen giriş dizisinde bazı istekler eksik olabilir. Tüm istekleri almak için sayfayı yeniden yükleyin. Genel olarak, getHAR() tarafından döndürülen isteklerin listesi, Ağ panelinde gösterilen listeyle eşleşmelidir.

Geliştirici Araçları API'lerinin kullanımına genel bir giriş için Geliştirici Araçları API'leri özeti bölümüne bakın.

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarların manifest dosyasında tanımlanması gerekir.

"devtools_page"

Örnekler

Aşağıdaki kod, 40 KB'tan büyük tüm resimlerin URL'lerini yüklendikleri sırada günlüğe kaydeder:

browser.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      browser.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

Bu API'yi denemek için chrome-extension-samples deposundan devtools API örneklerini yükleyin.

Türler

Request

Bir belge kaynağı (komut dosyası, resim vb.) için ağ isteğini temsil eder. Referans için HAR Spesifikasyonu'na bakın.

Özellikler

  • getContent

    geçersiz

    Yanıt gövdesinin içeriğini döndürür.

    getContent işlevi şu şekildedir: 

    () => {...}

    • returns

      Promise<object>

      Chrome 151 ve sonraki sürümler Chrome 152'den itibaren browser.*

      İstek tamamlandığında yanıt gövdesini alan bir işlev.

Yöntemler

getHAR()

browser.devtools.network.getHAR(): Promise<object>

Bilinen tüm ağ isteklerini içeren HAR günlüğünü döndürür.

İadeler

  • Promise<object>

    Chrome 151 ve sonraki sürümler Chrome 152'den itibaren browser.*

    İstek tamamlandığında HAR günlüğünü alan bir işlev.

Etkinlikler

onNavigated

browser.devtools.network.onNavigated.addListener(
  callback: function,
)

İncelenen pencere yeni bir sayfaya gittiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

    (url: string) => void

    • url

      dize

onRequestFinished

browser.devtools.network.onRequestFinished.addListener(
  callback: function,
)

Bir ağ isteği tamamlandığında ve tüm istek verileri kullanılabilir olduğunda tetiklenir.

Parametreler

  • callback

    işlev

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

    (request: Request) => void