browser.devtools.network

الوصف

استخدِم واجهة برمجة التطبيقات chrome.devtools.network لاسترداد المعلومات حول طلبات الشبكة التي تعرضها "أدوات المطوّرين" في لوحة "الشبكة".

يتم تمثيل معلومات طلبات الشبكة بتنسيق أرشيف HTTP‏ (HAR). لا يندرج وصف ملف HAR ضمن نطاق هذا المستند، لذا يُرجى الرجوع إلى مواصفات HAR v1.2.

في ما يتعلق بملف HAR، تعرض طريقة browser.devtools.network.getHAR() سجلّ HAR بالكامل، بينما يوفّر حدث browser.devtools.network.onRequestFinished إدخال HAR كوسيطة لردّ الاتصال بالحدث.

يُرجى العِلم أنّ محتوى الطلب لا يتم توفيره كجزء من ملف HAR لأسباب تتعلق بالكفاءة. يمكنك استدعاء طريقة getContent() للطلب من أجل استرداد المحتوى.

إذا تم فتح نافذة "أدوات المطوّرين" بعد تحميل الصفحة، قد لا تظهر بعض الطلبات في مصفوفة الإدخالات التي يعرضها getHAR(). أعِد تحميل الصفحة للحصول على جميع الطلبات. بشكل عام، يجب أن تتطابق قائمة الطلبات التي يعرضها getHAR() مع تلك المعروضة في لوحة الشبكة.

يمكنك الاطّلاع على ملخّص واجهات برمجة التطبيقات في "أدوات مطوّري البرامج" للحصول على مقدمة عامة حول استخدام واجهات برمجة التطبيقات في "أدوات مطوّري البرامج".

البيان

يجب الإعلان عن المفاتيح التالية في ملف البيان لاستخدام واجهة برمجة التطبيقات هذه.

"devtools_page"

أمثلة

يسجّل الرمز التالي عناوين URL لجميع الصور التي يزيد حجمها عن 40 كيلوبايت أثناء تحميلها:

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

لتجربة واجهة برمجة التطبيقات هذه، يمكنك تثبيت أمثلة على واجهة برمجة التطبيقات لأدوات مطوّري البرامج من مستودع chrome-extension-samples.

الأنواع

Request

تمثّل طلب شبكة لمصدر مستند (نص برمجي وصورة وما إلى ذلك). يمكنك الاطّلاع على مواصفات HAR كمرجع.

الخصائص

• getContent

  void

  تعرض هذه السمة محتوى نص الردّ.

  تبدو الدالة getContent على النحو التالي:

  () => {...}

  • returns

    وعد<كائن>

    الإصدار 151 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 152 من Chrome

    دالة تتلقّى نص الاستجابة عند اكتمال الطلب.

الطُرق

getHAR()

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

تعرض هذه الطريقة سجلّ HAR الذي يحتوي على جميع طلبات الشبكة المعروفة.

المرتجعات

• وعد<كائن>

  الإصدار 151 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 152 من Chrome

  دالة تتلقّى سجلّ HAR عند اكتمال الطلب

الفعاليات

onNavigated

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

يتم تنشيطه عندما تنتقل النافذة التي يتم فحصها إلى صفحة جديدة.

المعلمات

• callback

  دالة

  تظهر المَعلمة callback على النحو التالي:

  (url: string) => void

  • url

    سلسلة

onRequestFinished

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

يتم تشغيل هذا الحدث عند انتهاء طلب الشبكة وتوفُّر جميع بيانات الطلب.

المعلمات

• callback

  دالة

  تظهر المَعلمة callback على النحو التالي:

  (request: Request) => void

  • طلب

    الطلب