browser.devtools.network

شرح

از chrome.devtools.network API برای بازیابی اطلاعات مربوط به درخواست‌های شبکه که توسط «ابزارهای توسعه‌دهندگان» در پانل «شبکه» نمایش داده می‌شود استفاده کنید.

اطلاعات درخواست‌های شبکه در قالب «بایگانی HTTP» (HAR) نشان داده می‌شود. شرح HAR خارج از محدوده این سند است، به مشخصات HAR v1.2 مراجعه کنید.

ازنظر HAR، روش browser.devtools.network.getHAR() کل گزارش HAR را برمی‌گرداند، درحالی‌که رویداد browser.devtools.network.onRequestFinished ورودی HAR را به‌عنوان آرگومان برای فراخوانی برگشتی رویداد ارائه می‌دهد.

توجه داشته باشید که محتوای درخواست به‌دلایل کارایی به‌عنوان بخشی از HAR ارائه نمی‌شود. می‌توانید روش getContent() درخواست را برای بازیابی محتوا فراخوانی کنید.

اگر پنجره «ابزارهای توسعه‌دهنده» پس‌از بار شدن صفحه باز شود، ممکن است برخی درخواست‌ها در آرایه ورودی‌های برگردانده‌شده توسط getHAR() وجود نداشته باشد. برای دریافت همه درخواست‌ها، صفحه را مجدداً بار کنید. به‌طور کلی، فهرست درخواست‌های برگردانده‌شده توسط getHAR() باید با آنچه در پانل «شبکه» نمایش داده می‌شود مطابقت داشته باشد.

برای آشنایی کلی با نحوه استفاده از میاناهای برنامه‌سازی کاربردی «ابزارهای توسعه‌دهندگان»، به خلاصه میاناهای برنامه‌سازی کاربردی DevTools مراجعه کنید.

مانیفست

برای استفاده از این میانای برنامه‌سازی کاربردی، کلیدهای زیر باید در مانیفست اعلام شوند.

"devtools_page"

مثال‌ها

کد زیر نشانی‌های وب همه تصاویر بزرگ‌تر از ۴۰ کیلوبایت را هنگام بار شدن ثبت می‌کند:

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

برای امتحان کردن این میانای برنامه‌سازی کاربردی، نمونه‌های میانای برنامه‌سازی کاربردی devtools را از مخزن chrome-extension-samples نصب کنید.

انواع

Request

نشان‌دهنده درخواست شبکه برای منبع سند (اسکریپت، تصویر، و غیره) است. برای مرجع، «مشخصات HAR» را ببینید.

مشخصات

  • getContent

    باطل کردن

    محتوای بدنه پاسخ را برمی‌گرداند.

    تابع getContent به‌صورت زیر است: 

    () => {...}

    • returns

      Promise<object>

      Chrome 151+ browser.* از Chrome 152

      تابعی که بدنه پاسخ را هنگام تکمیل درخواست دریافت می‌کند.

روش‌ها

getHAR()

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

گزارش HAR را که حاوی همه درخواست‌های شبکه شناخته‌شده است برمی‌گرداند.

بازگشتی‌ها

  • Promise<object>

    Chrome 151+ browser.* از Chrome 152

    تابعی که گزارش HAR را پس‌از تکمیل درخواست دریافت می‌کند.

رویدادها

onNavigated

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

وقتی پنجره بازرسی‌شده به صفحه جدیدی پیمایش می‌کند، فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (url: string) => void

    • نشانی وب

      رشته

onRequestFinished

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

وقتی درخواست شبکه تمام شود و همه داده‌های درخواست دردسترس باشد، فعال می‌شود.

پارامترها

  • تماس برگشتی

    عملکرد

    پارامتر callback به‌صورت زیر است: 

    (request: Request) => void