chrome.devtools.network

الوصف

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

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

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

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

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

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

البيان

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

"devtools_page"

أمثلة

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

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 على النحو التالي: 

    () => {...}

    • returns

      Promise<object>

      في انتظار المراجعة

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

الطُرق

getHAR()

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

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

المرتجعات

  • Promise<object>

    في انتظار المراجعة

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

الفعاليات

onNavigated

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

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

المعلمات

  • callback

    دالة

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

    (url: string) => void

    • url

      سلسلة

onRequestFinished

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

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

المعلمات

  • callback

    دالة

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

    (request: Request) => void