chrome.devtools.network

refresh date: 2026-09-25 robots: noindex

الوصف

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

البيان

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

"devtools_page"

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

نظرة عامة

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

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

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

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

أمثلة

يسجّل الرمز التالي عناوين 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) + '"))');
    }
  }
);

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

الأنواع

Request

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

الخصائص

  • getContent

    void

    Promise

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

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

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

    • callback

      function اختياري

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

      (response: object) => void

      • رد

        عنصر

        الإصدار 151 من Chrome والإصدارات الأحدث

        عنصر يحتوي على نص الاستجابة وترميزه

        • المحتوى

          سلسلة

          محتوى نص الاستجابة (قد يكون مرمّزًا)

        • الترميز

          سلسلة

          يكون هذا الحقل فارغًا إذا لم يتم ترميز المحتوى، وإلا سيظهر اسم الترميز. في الوقت الحالي، يتوفّر base64 فقط.

    • returns

      وعد<كائن>

      الإصدار 151 من Chrome والإصدارات الأحدث

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

      لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

الطُرق

getHAR()

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

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

المعلمات

  • callback

    function اختياري

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

    (harLog: object) => void

    • harLog

      عنصر

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

المرتجعات

  • وعد<كائن>

    الإصدار 151 من Chrome والإصدارات الأحدث

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

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، وتحتاج المنصات الأخرى إلى استخدام عمليات الاستدعاء.

الفعاليات

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