browser.devtools.network

Deskripsi

Gunakan chrome.devtools.network API untuk mengambil informasi tentang permintaan jaringan yang ditampilkan oleh Developer Tools di panel Jaringan.

Informasi permintaan jaringan direpresentasikan dalam format HTTP Archive (HAR). Deskripsi HAR berada di luar cakupan dokumen ini, lihat Spesifikasi HAR v1.2.

Dalam hal HAR, metode browser.devtools.network.getHAR() menampilkan seluruh log HAR, sedangkan peristiwa browser.devtools.network.onRequestFinished menyediakan entri HAR sebagai argumen untuk callback peristiwa.

Perhatikan bahwa konten permintaan tidak disediakan sebagai bagian dari HAR karena alasan efisiensi. Anda dapat memanggil metode getContent() permintaan untuk mengambil konten.

Jika jendela Developer Tools dibuka setelah halaman dimuat, beberapa permintaan mungkin tidak ada dalam array entri yang ditampilkan oleh getHAR(). Muat ulang halaman untuk mendapatkan semua permintaan. Secara umum, daftar permintaan yang ditampilkan oleh getHAR() harus cocok dengan yang ditampilkan di panel Jaringan.

Lihat Ringkasan API DevTools untuk pengantar umum tentang penggunaan API Alat Developer.

Manifes

Kunci berikut harus dideklarasikan dalam manifes untuk menggunakan API ini.

"devtools_page"

Contoh

Kode berikut mencatat URL semua gambar yang berukuran lebih dari 40 KB saat dimuat:

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) + '"))');
    }
  }
);

Untuk mencoba API ini, instal contoh API devtools dari repositori chrome-extension-samples.

Jenis

Request

Merepresentasikan permintaan jaringan untuk resource dokumen (skrip, gambar, dan sebagainya). Lihat Spesifikasi HAR untuk referensi.

Properti

  • getContent

    void

    Menampilkan konten isi respons.

    Fungsi getContent terlihat seperti: 

    () => {...}

    • return

      Promise<object>

      Chrome 151+ browser.* sejak Chrome 152

      Fungsi yang menerima isi respons saat permintaan selesai.

Metode

getHAR()

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

Menampilkan log HAR yang berisi semua permintaan jaringan yang diketahui.

Hasil

  • Promise<object>

    Chrome 151+ browser.* sejak Chrome 152

    Fungsi yang menerima log HAR saat permintaan selesai.

Acara

onNavigated

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

Diaktifkan saat jendela yang diperiksa membuka halaman baru.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (url: string) => void

    • url

      string

onRequestFinished

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

Diaktifkan saat permintaan jaringan selesai dan semua data permintaan tersedia.

Parameter

  • callback

    fungsi

    Parameter callback terlihat seperti: 

    (request: Request) => void