תיאור
כדי להתאים אישית את חלונית מכשיר ההקלטה בכלי הפיתוח, צריך להשתמש ב-API chrome.devtools.recorder
.
למבוא כללי לשימוש בממשקי API של כלים למפתחים, אפשר לעיין בסיכום ממשקי ה-API של כלי הפיתוח.
זמינות
מושגים ושימוש
ה-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
מייצג תצוגה שנוצרה על ידי תוסף שתוטמע בחלונית מכשיר ההקלטה.
מאפיינים
-
onHidden
אירוע<functioncancelcancel>
מופעל כשהתצוגה מוסתרת.
הפונקציה
onHidden.addListener
נראית כך:(callback: function) => {...}
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:() => void
-
-
onShown
אירוע<functioncancelcancel>
מופעל כשמוצגת תצוגה.
הפונקציה
onShown.addListener
נראית כך:(callback: function) => {...}
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:() => void
-
-
הצג
ריק
מציין שהתוסף רוצה להציג את התצוגה הזו בחלונית 'מכשיר הקלטה'.
הפונקציה
show
נראית כך:() => {...}
שיטות
createView()
chrome.devtools.recorder.createView(
title: string,
pagePath: string,
)
יצירת תצוגה שיכולה לטפל בשידור החוזר. התצוגה הזו תוטמע בחלונית של מכשיר ההקלטה.
פרמטרים
-
title
מחרוזת
כותרת שמוצגת לצד סמל התוסף בסרגל הכלים של הכלים למפתחים.
-
pagePath
מחרוזת
הנתיב של דף ה-HTML של הלוח, ביחס לספריית התוספים.
החזרות
registerRecorderExtensionPlugin()
chrome.devtools.recorder.registerRecorderExtensionPlugin(
plugin: RecorderExtensionPlugin,
name: string,
mediaType: string,
)
רושם פלאגין תוסף של מכשיר ההקלטה.
פרמטרים
-
יישומי פלאגין
מכונה שמטמיעה את הממשק של RecorderExtensionPlugin.
-
שם
מחרוזת
שם הפלאגין.
-
mediaType
מחרוזת
סוג המדיה של תוכן המחרוזת שהפלאגין מפיק.