chrome.devtools.performance

תיאור

כדי להתאים אישית את חלונית מכשיר ההקלטה בכלי הפיתוח, צריך להשתמש ב-API chrome.devtools.recorder.

למבוא כללי לשימוש בממשקי API של כלים למפתחים, אפשר לעיין בסיכום ממשקי ה-API של כלי הפיתוח.

זמינות

Chrome 105+

החל מגרסה 128 של Chrome, תוכלו להאזין להתראות לגבי סטטוס ההקלטה של חלונית הביצועים.

מושגים ושימוש

ה-API chrome.devtools.performance מאפשר למפתחים ליצור אינטראקציה עם תכונות ההקלטה של החלונית חלונית הביצועים בכלי הפיתוח ל-Chrome. אפשר להשתמש ב-API הזה כדי לקבל התראות כשההקלטה מתחילה או מפסיקה.

יש שני אירועים:

• onProfilingStarted: האירוע הזה מופעל כשהחלונית ביצועים מתחילה לתעד נתוני ביצועים.
• onProfilingStopped: האירוע הזה מופעל כשהחלונית ביצועים מפסיקה לתעד נתוני ביצועים. שמשייכת את דוח הקריסות הנוכחי לקוד לשני האירועים אין פרמטרים משויכים.

אם תאזינו לאירועים האלה, המפתחים יוכלו ליצור תוספים שמגיבים לסטטוס ההקלטה בחלונית ביצועים. כך הם יוכלו לספק אוטומציה נוספת במהלך הפרופיילינג של הביצועים.

דוגמאות

כך אפשר להשתמש ב-API כדי להאזין לעדכוני סטטוס של הקלטות

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

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

סוגים

RecorderExtensionPlugin

ממשק פלאגין שמופעל בחלונית מכשיר ההקלטה כדי להתאים אישית את החלונית של מכשיר ההקלטה.

מאפיינים

• הפעלה מחדש

  ריק

  Chrome 112 ואילך

  מאפשר לתוסף להטמיע פונקציונליות מותאמת אישית של הפעלה מחדש.

  הפונקציה replay נראית כך:

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

  • להקליט את

    אובייקט

    תיעוד האינטראקציה של המשתמש עם הדף. היא צריכה להתאים לסכימת ההקלטה של Puppeteer.

• stringify

  ריק

  הפונקציה ממירה הקלטה מהפורמט של לוח מכשיר ההקלטה למחרוזת.

  הפונקציה stringify נראית כך:

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

  • להקליט את

    אובייקט

    תיעוד האינטראקציה של המשתמש עם הדף. היא צריכה להתאים לסכימת ההקלטה של Puppeteer.

• stringifyStep

  ריק

  הפונקציה ממירה שלב בהקלטה מפורמט לוח מכשיר ההקלטה למחרוזת.

  הפונקציה stringifyStep נראית כך:

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

  • שלב

    אובייקט

    שלב בהקלטת האינטראקציה של משתמש עם הדף. היא צריכה להתאים לסכימת השלבים של Puppeteer.

RecorderView

Chrome 112 ואילך

מייצג תצוגה שנוצרה על ידי תוסף שתוטמע בחלונית מכשיר ההקלטה.

מאפיינים

• onHidden

  אירוע<functioncancelcancel>

  מופעל כשהתצוגה מוסתרת.

  הפונקציה onHidden.addListener נראית כך:

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

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך:

    () => void

• onShown

  אירוע<functioncancelcancel>

  מופעל כשמוצגת תצוגה.

  הפונקציה onShown.addListener נראית כך:

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

  • קריאה חוזרת (callback)

    פונקציה

    הפרמטר callback נראה כך:

    () => void

• הצג

  ריק

  מציין שהתוסף רוצה להציג את התצוגה הזו בחלונית 'מכשיר הקלטה'.

  הפונקציה show נראית כך:

  () => {...}

שיטות

createView()

Chrome 112 ואילך

chrome.devtools.recorder.createView(
  title: string,
  pagePath: string,
)

יצירת תצוגה שיכולה לטפל בשידור החוזר. התצוגה הזו תוטמע בחלונית של מכשיר ההקלטה.

פרמטרים

• title

  מחרוזת

  כותרת שמוצגת לצד סמל התוסף בסרגל הכלים של הכלים למפתחים.

• pagePath

  מחרוזת

  הנתיב של דף ה-HTML של הלוח, ביחס לספריית התוספים.

החזרות

• RecorderView

registerRecorderExtensionPlugin()

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

רושם פלאגין תוסף של מכשיר ההקלטה.

פרמטרים

• יישומי פלאגין

  RecorderExtensionPlugin

  מכונה שמטמיעה את הממשק של RecorderExtensionPlugin.

• שם

  מחרוזת

  שם הפלאגין.

• mediaType

  מחרוזת

  סוג המדיה של תוכן המחרוזת שהפלאגין מפיק.