chrome.devtools.network

الوصف

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

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

من حيث 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 API من مستودع chrome-extension-pattern.

الأنواع

Request

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

أماكن إقامة

  • getContent

    void

    تعرض محتوى نص الاستجابة.

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

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

    • معاودة الاتصال

      الوظيفة

      تبدو معلَمة callback على النحو التالي: 

      (content: string,encoding: string)=>void

      • بمحتوى

        سلسلة

        محتوى نص الاستجابة (الذي يُحتمَل أن يكون مشفَّرًا)

      • الترميز

        سلسلة

        يكون هذا الحقل فارغًا إذا لم يتم ترميز المحتوى، وسيتم ترميز اسم الترميز بطريقة أخرى. في الوقت الحالي، لا يمكن استخدام سوى base64.

الطُرق

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (harLog: object)=>void

    • harLog

      كائن

      سجل HAR. لمزيد من التفاصيل، يُرجى الاطّلاع على مواصفات HAR.

فعاليات

onNavigated

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (url: string)=>void

    • url

      سلسلة

onRequestFinished

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

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

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (request: Request)=>void