الوصف
استخدِم واجهة برمجة تطبيقات chrome.devtools.network
لاسترداد المعلومات حول طلبات الشبكة التي تعرضها أدوات المطوّرين في لوحة الشبكة.
البيان
يجب الإعلان عن المفاتيح التالية في ملف البيان كي تتمكّن من استخدام واجهة برمجة التطبيقات هذه.
"devtools_page"
يمكنك الاطّلاع على ملخّص عن واجهات برمجة التطبيقات في أدوات مطوّري البرامج للحصول على مقدمة عامة عن استخدام واجهات برمجة التطبيقات الخاصة بـ "أدوات مطوّري البرامج".
نظرة عامة
يتم تمثيل معلومات طلبات الشبكة بتنسيق أرشيف HTTP (HAR). وصف HAR خارج نطاق هذا المستند. يُرجى الرجوع إلى HAR v1.2 Specification.
من حيث 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-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
-
سلسلة
-
onRequestFinished
chrome.devtools.network.onRequestFinished.addListener(
callback: function,
)
يتم تنشيطها عند الانتهاء من طلب الشبكة وتوفّر جميع بيانات الطلب.