chrome.devtools.network

תיאור

צריך להשתמש ב-API chrome.devtools.network כדי לאחזר את המידע על בקשות רשת שמוצגות על ידי הכלים למפתחים בחלונית הרשת.

מניפסט

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

"devtools_page"

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

סקירה כללית

המידע על בקשות רשת מיוצג בפורמט HTTP Archive (HAR). התיאור של HAR לא נכללת במסמך הזה. מומלץ לעיין במפרט HAR v1.2.

מבחינת HAR, השיטה chrome.devtools.network.getHAR() מחזירה את יומן HAR כולו, האירוע chrome.devtools.network.onRequestFinished מספק רשומת HAR כארגומנט לאירוע קריאה חוזרת.

שימו לב שתוכן הבקשות לא מסופק כחלק מ-HAR מטעמי יעילות. אפשר להתקשר שיטת getContent() של הבקשה כדי לאחזר תוכן.

אם חלון הכלים למפתחים נפתח אחרי שהדף נטען, יכול להיות שחלק מהבקשות יהיו חסרות מערך הרשומות שהוחזר על ידי getHAR(). כדי לקבל את כל הבקשות צריך לטעון מחדש את הדף. באופן כללי, רשימת הבקשות שהוחזרו על ידי getHAR() צריכה להיות זהה לזו שמוצגת בחלונית 'רשת'.

דוגמאות

הקוד הבא מתעד את כתובות ה-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 הזה, צריך להתקין את הדוגמאות של ממשקי devtools API מ-chrome-extension-samples. של מאגר הנתונים.

סוגים

Request

מייצג בקשת רשת למשאב מסמך (סקריפט, תמונה וכו'). מידע נוסף מופיע במפרט ה-HAR.

מאפיינים

  • getContent

    ריק

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

    הפונקציה 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