chrome.devtools.network

תיאור

אפשר להשתמש ב-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 של כלים למפתחים.

מניפסט

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

"devtools_page"

דוגמאות

כתובות ה-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)

    פונקציה

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

    (url: string)=>void

    • כתובת אתר

      מחרוזת

onRequestFinished

chrome.devtools.network.onRequestFinished.addListener(
  callback: function,
)

מופעל כשבקשת רשת מסתיימת וכל נתוני הבקשה זמינים.

פרמטרים

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

    פונקציה

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

    (request: Request)=>void