chrome.devtools.network

refresh date: 2026-09-25 robots: noindex

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.

Manifest

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

"devtools_page"

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.

Genel Bakış

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

HAR açısından, chrome.devtools.network.getHAR() yöntemi HAR günlüğünün tamamını döndürürken chrome.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.

Örnekler

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

chrome.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      chrome.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

    Taahhüt

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

    getContent işlevi şu şekildedir: 

    (callback?: function) => {...}

    • callback

      function isteğe bağlı

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

      (response: object) => void

      • gönderin

        nesne

        Chrome 151+

        Yanıt gövdesini ve kodlamasını içeren bir nesne.

        • içerik

          dize

          Yanıt gövdesinin içeriği (kodlanmış olabilir).

        • kodlama

          dize

          İçerik kodlanmamışsa boş, kodlanmışsa kodlama adı. Şu anda yalnızca base64 desteklenmektedir.

    • returns

      Promise<object>

      Chrome 151+

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

      Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Yöntemler

getHAR()

Taahhüt 
chrome.devtools.network.getHAR(
  callback?: function,
): Promise<object>

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

Parametreler

  • callback

    function isteğe bağlı

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

    (harLog: object) => void

    • harLog

      nesne

      HAR günlüğü Ayrıntılar için HAR spesifikasyonuna bakın.

İadeler

  • Promise<object>

    Chrome 151+

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

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onNavigated

chrome.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

chrome.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