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

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

الأنواع

Request

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

الخصائص

  • getContent

    باطل

    وعد

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

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

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

    • callback

      الدالة اختيارية

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

      (response: object) => void

      • رد

        عنصر

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

        عنصر يحتوي على نص الاستجابة وتشفيره.

        • المحتوى

          سلسلة

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

        • الترميز

          سلسلة

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

    • returns

      Promise<object>

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

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

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

الطُرق

getHAR()

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

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

المعلمات

  • callback

    الدالة اختيارية

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

    (harLog: object) => void

    • harLog

      عنصر

      سجلّ HAR راجِع مواصفات HAR للحصول على التفاصيل.

المرتجعات

  • Promise<object>

    الإصدار 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