תיאור
אפשר להשתמש ב-chrome.devtools.network
API כדי לאחזר את המידע על בקשות הרשת שמוצגות על ידי הכלים למפתחים בחלונית 'רשת'.
מידע של בקשות רשת מיוצג בפורמט HTTP Archive (HAR). התיאור של HAR לא נכלל במסמך הזה. עיינו במפרט של גרסה 1.2 HAR.
במונחים של HAR, השיטה chrome.devtools.network.getHAR()
מחזירה את כל יומן HAR, ואילו האירוע chrome.devtools.network.onRequestFinished
מספק רשומת HAR כארגומנט של הקריאה החוזרת לאירוע.
שימו לב שתוכן הבקשה לא מסופק כחלק מ-HAR מטעמי יעילות. אפשר לקרוא לשיטה getContent()
של הבקשה לאחזור תוכן.
אם החלון של הכלים למפתחים נפתח אחרי שהדף נטען, יכול להיות שחלק מהבקשות יהיו חסרות במערך הרשומות שמוחזר על ידי getHAR()
. כדי לקבל את כל הבקשות, צריך לטעון מחדש את הדף. באופן כללי, רשימת הבקשות שהוחזרה על ידי getHAR()
אמורה להתאים לזו שמוצגת בחלונית Network.
אפשר לעיין בסיכום של ממשקי ה-API למפתחים כדי לקבל מבוא כללי לשימוש בממשקי ה-API של כלים למפתחים.
מניפסט
דוגמאות
כתובות ה-URL של כל התמונות שגדולות מ-40KB נטענות בזמן שהן נטענות:
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) + '"))');
}
}
);
כדי לנסות את ה-API הזה, צריך להתקין את דוגמאות ל-API של devtools מהמאגר chrome-extension-samples.
סוגים
Request
מייצגת בקשת רשת למשאב של מסמך (סקריפט, תמונה וכן הלאה). לעיון במפרט HAR.
תכונות
-
getContent
void
מחזירה את התוכן של גוף התשובה.
הפונקציה
getContent
נראית כך:(callback: function) => {...}
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(content: string, encoding: string) => void
-
רווחי
מחרוזת
התוכן של גוף התשובה (אולי יש לו קידוד).
-
קידוד
מחרוזת
אם התוכן לא מקודד, השם ריק אם הוא לא מקודד אחרת. נכון לעכשיו, יש תמיכה רק ב-base64.
-
-
שיטות
getHAR()
chrome.devtools.network.getHAR(
callback: function,
)
מחזירה יומן HAR שמכיל את כל בקשות הרשת הידועות.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
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,
)
מופעל כשבקשת רשת מסתיימת וכל נתוני הבקשה זמינים.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(request: Request) => void
-
בקשה
-