chrome.devtools.network

refresh date: 2026-09-25 robots: noindex

شرح

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

مانیفست

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

"devtools_page"

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

نمای کلی

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

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

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

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

مثال‌ها

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

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

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

انواع

Request

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

مشخصات

  • getContent

    باطل کردن

    قول

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

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

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

    • تماس برگشتی

      تابع اختیاری

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

      (response: object) => void

      • پاسخ

        شیء

        Chrome نسخه ۱۵۱ و بالاتر

        شیئی که حاوی بدنه پاسخ و کدبندی آن است.

        • محتوا

          رشته

          محتوای بدنه پاسخ (احتمالاً کدگذاری‌شده).

        • کدبندی

          رشته

          اگر محتوا کدگذاری نشده باشد، خالی است، درغیراین‌صورت نام کدگذاری است. درحال‌حاضر، فقط base64 پشتیبانی می‌شود.

    • returns

      Promise<object>

      Chrome نسخه ۱۵۱ و بالاتر

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

      ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

روش‌ها

getHAR()

قول 
chrome.devtools.network.getHAR(
  callback?: function,
): Promise<object>

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

پارامترها

  • تماس برگشتی

    تابع اختیاری

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

    (harLog: object) => void

    • harLog

      شیء

      گزارش HAR. برای جزئیات، مشخصات HAR را ببینید.

بازگشتی‌ها

  • Promise<object>

    Chrome نسخه ۱۵۱ و بالاتر

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

    ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

رویدادها

onNavigated

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

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

پارامترها

  • تماس برگشتی

    عملکرد

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

    (url: string) => void

    • نشانی وب

      رشته

onRequestFinished

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

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

پارامترها

  • تماس برگشتی

    عملکرد

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

    (request: Request) => void