chrome.devtools.network

Açıklama

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

Manifest

Bu API'yi kullanmak için aşağıdaki anahtarlar manifest dosyasında beyan edilmelidir.

"devtools_page"

Geliştirici Araçları API'lerini kullanmaya ilişkin genel bir giriş için Geliştirici Araçları API'lerine genel bakış başlıklı makaleyi inceleyin.

Genel Bakış

Ağ isteği bilgileri, HTTP Arşivi biçiminde (HAR) gösterilir. HAR'ın açıklaması bu belgenin kapsamı dışındadır. Lütfen HAR 1.2 sürümü spesifikasyonuna 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ğırmasına bağımsız değişken olarak HAR girişi sağlar.

İstek içeriğinin, verimlilik nedeniyle HAR'a dahil edilmediğini 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österilenlerle 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 doküman kaynağı (komut dosyası, resim vb.) için ağ isteğini temsil eder. Referans için HAR Spesifikasyonu'na bakın.

Özellikler

  • getContent

    geçersiz

    Promise

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

    getContent işlevi şu şekilde görünür: 

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

    • callback

      işlev isteğe bağlı

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

      (response: object) => void

      • gönderin

        nesne

        Beklemede

        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ş, aksi takdirde kodlama adı. Şu anda yalnızca base64 desteklenmektedir.

    • returns

      Promise<object>

      Beklemede

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

      Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Yöntemler

getHAR()

Promise 
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

    işlev 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>

    Beklemede

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

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