chrome.devtools.network

refresh date: 2026-09-25 robots: noindex

תיאור

אפשר להשתמש ב-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 כארגומנט לקריאה החוזרת (callback) של האירוע.

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

סוגים

Request

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

מאפיינים

  • getContent

    void

    Promise

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

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

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

    • callback

      function optional

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

      (response: object) => void

      • תשובה

        אובייקט

        ‫Chrome מגרסה 151 ואילך

        אובייקט שמכיל את גוף התגובה והקידוד שלו.

        • תוכן

          מחרוזת

          התוכן של גוף התגובה (יכול להיות מקודד).

        • קידוד

          מחרוזת

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

    • החזרות

      Promise<object>

      ‫Chrome מגרסה 151 ואילך

      פונקציה שמקבלת את גוף התגובה כשהבקשה מסתיימת.

      הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

Methods

getHAR()

Promise 
chrome.devtools.network.getHAR(
  callback?: function,
): Promise<object>

הפונקציה מחזירה יומן HAR שמכיל את כל הבקשות הידועות לאחזור מהרשת.

פרמטרים

  • callback

    function optional

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

    (harLog: object) => void

    • harLog

      אובייקט

      יומן HAR. פרטים נוספים זמינים במפרט של HAR.

החזרות

  • Promise<object>

    ‫Chrome מגרסה 151 ואילך

    פונקציה שמקבלת את יומן ה-HAR כשהבקשה מסתיימת.

    הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

אירועים

onNavigated

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

מופעל כשהחלון שנבדק מנווט לדף חדש.

פרמטרים

  • callback

    פונקציה

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

    (url: string) => void

    • url

      מחרוזת

onRequestFinished

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

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

פרמטרים

  • callback

    פונקציה

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

    (request: Request) => void