chrome.devtools.performance

الوصف

استخدِم واجهة برمجة التطبيقات chrome.devtools.recorder لتخصيص لوحة "المسجّلة الذكية" في "أدوات مطوري البرامج".

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

مدى التوفّر

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

المفاهيم والاستخدام

تسمح واجهة برمجة التطبيقات chrome.devtools.performance للمطوّرين بالتفاعل مع ميزات التسجيل في لوحة لوحة الأداء ضمن "أدوات مطوري البرامج في Chrome". يمكنك استخدام واجهة برمجة التطبيقات هذه لتلقّي إشعارات عند بدء التسجيل أو إيقافه.

يتوفر نوعان من الأحداث:

  • onProfilingStarted: يتم تنشيط هذا الحدث عندما تبدأ لوحة الأداء في تسجيل بيانات الأداء.
  • onProfilingStopped: يتم تنشيط هذا الحدث عندما تتوقف لوحة الأداء عن تسجيل بيانات الأداء. الذي يربط تتبُّع تسلسل استدعاء الدوال البرمجية الحالي بوحدة القياس لا يتضمّن كلا الحدثَين أي معلَمات مرتبطة.

من خلال الاستماع إلى هذه الأحداث، يمكن للمطوّرين إنشاء إضافات تتفاعل مع حالة التسجيل في لوحة الأداء، ما يوفّر عمليات تشغيل آلي إضافية أثناء تحليل الأداء.

أمثلة

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


chrome.devtools.performance.onProfilingStarted.addListener(() => {
  // Profiling started listener implementation
});

chrome.devtools.performance.onProfilingStopped.addListener(() => {
  // Profiling stopped listener implementation
})

الأنواع

RecorderExtensionPlugin

واجهة مكوِّن إضافي تستدعيها لوحة "المسجّلة الذكية" لتخصيص لوحة "المسجّلة الذكية"

أماكن إقامة

  • إعادة التشغيل

    فراغ

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

    يسمح هذا الإذن للإضافة بتنفيذ وظيفة إعادة تشغيل مخصّصة.

    تبدو دالة replay كما يلي: 

    (recording: object) => {...}

    • تسجيل

      كائن

      تسجيل لتفاعل المستخدم مع الصفحة يجب أن يتطابق هذا الاسم مع مخطّط تسجيل Puppeteer.

  • stringify

    فراغ

    تحوِّل هذه الميزة تسجيلاً من تنسيق لوحة "المسجّلة الذكية" إلى سلسلة.

    تبدو دالة stringify كما يلي: 

    (recording: object) => {...}

    • تسجيل

      كائن

      تسجيل لتفاعل المستخدم مع الصفحة يجب أن يتطابق هذا الاسم مع مخطّط تسجيل Puppeteer.

  • stringifyStep

    فراغ

    تحوّل خطوة التسجيل من تنسيق لوحة "المسجّلة الذكية" إلى سلسلة.

    تبدو دالة stringifyStep كما يلي: 

    (step: object) => {...}

    • خطوة

      كائن

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

RecorderView

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

تمثل طريقة العرض التي تم إنشاؤها بواسطة الإضافة ليتم تضمينها داخل لوحة "المسجّلة الذكية".

أماكن إقامة

  • onHidden

    الحدث <functionuffful>

    يتم الإطلاق عند إخفاء العرض.

    تبدو دالة onHidden.addListener كما يلي: 

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

    • رد الاتصال

      دالة

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

      () => void

  • onShown

    الحدث <functionuffful>

    يتم الإطلاق عند إظهار العرض.

    تبدو دالة onShown.addListener كما يلي: 

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

    • رد الاتصال

      دالة

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

      () => void

  • إظهار

    فراغ

    تشير هذه العلامة إلى أنّ الإضافة تريد إظهار طريقة العرض هذه في لوحة "المسجّلة الذكية".

    تبدو دالة show كما يلي: 

    () => {...}

الطُرق

createView()

الإصدار 112 من Chrome أو الإصدارات الأحدث 
chrome.devtools.recorder.createView(
  title: string,
  pagePath: string,
)

إنشاء طريقة عرض يمكنها معالجة إعادة التشغيل سيتم تضمين طريقة العرض هذه داخل لوحة "المسجّلة الذكية".

المَعلمات

  • title

    سلسلة

    العنوان الذي يتم عرضه بجانب رمز الإضافة في شريط أدوات "أدوات المطوّرين"

  • pagePath

    سلسلة

    مسار صفحة HTML في اللوحة بالنسبة إلى دليل الإضافات.

المرتجعات

registerRecorderExtensionPlugin()

chrome.devtools.recorder.registerRecorderExtensionPlugin(
  plugin: RecorderExtensionPlugin,
  name: string,
  mediaType: string,
)

لتسجيل المكوّن الإضافي للإضافة "المسجّلة الذكية".

المَعلمات

  • المكوّن الإضافي

    RecorderExtensionPlugin

    مثيل ينفذ واجهة RecorderExtensionAccessin

  • الاسم

    سلسلة

    تمثّل هذه السمة اسم المكوِّن الإضافي.

  • mediaType

    سلسلة

    نوع الوسائط لمحتوى السلسلة الذي ينتجه المكوِّن الإضافي.