chrome.devtools.network

Beschreibung

Mit der chrome.devtools.network API können Sie die Informationen zu Netzwerkanfragen abrufen, die in den Entwicklertools im Bereich „Netzwerk“ angezeigt werden.

Informationen zu Netzwerkanfragen werden im HTTP-Archiv-Format (HAR) dargestellt. Die Beschreibung von HAR wird in diesem Dokument nicht behandelt. Weitere Informationen finden Sie in der Spezifikation für HAR-Version 1.2.

In Bezug auf HAR gibt die Methode chrome.devtools.network.getHAR() das gesamte HAR-Protokoll zurück, während das chrome.devtools.network.onRequestFinished-Ereignis einen HAR-Eintrag als Argument für den Ereignis-Callback bereitstellt.

Bitte beachten Sie, dass Anforderungsinhalte aus Effizienzgründen nicht als Teil von HAR bereitgestellt werden. Sie können die Methode getContent() der Anfrage aufrufen, um Inhalte abzurufen.

Wenn das Fenster der Entwicklertools nach dem Laden der Seite geöffnet wird, fehlen möglicherweise einige Anfragen im Array der von getHAR() zurückgegebenen Einträge. Aktualisieren Sie die Seite, um alle Anfragen abzurufen. Im Allgemeinen sollte die Liste der von getHAR() zurückgegebenen Anfragen derjenigen entsprechen, die im Steuerfeld „Netzwerk“ angezeigt wird.

Eine allgemeine Einführung in die Verwendung von APIs für Entwicklertools finden Sie unter Zusammenfassung der Entwicklertools-APIs.

Manifest

Die folgenden Schlüssel müssen im Manifest deklariert werden, um diese API verwenden zu können.

"devtools_page"

Beispiele

Mit dem folgenden Code werden beim Laden die URLs aller Bilder protokolliert, die größer als 40 KB sind:

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) + '"))');
    }
  }
);

Wenn Sie diese API testen möchten, installieren Sie die devtools API-Beispiele aus dem Repository chrome-extension-sample.

Typen

Request

Stellt eine Netzwerkanfrage für eine Dokumentressource (Skript, Bild usw.) dar. Weitere Informationen finden Sie in der HAR-Spezifikation.

Attribute

  • getContent

    void

    Gibt den Inhalt des Antworttexts zurück

    Die Funktion getContent sieht so aus: 

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

    • callback

      Funktion

      Der Parameter callback sieht so aus: 

      (content: string,encoding: string)=>void

      • Inhalte herausgestellt werden

        String

        Inhalt des Antworttexts (möglicherweise codiert).

      • encoding

        String

        Leer, wenn der Inhalt nicht codiert ist, andernfalls Codierungsname. Derzeit wird nur base64 unterstützt.

Methoden

getHAR()

chrome.devtools.network.getHAR(
  callback: function,
)

Gibt ein HAR-Protokoll zurück, das alle bekannten Netzwerkanfragen enthält.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (harLog: object)=>void

    • harLog

      Objekt

      Ein HAR-Protokoll. Weitere Informationen finden Sie in der HAR-Spezifikation.

Veranstaltungen

onNavigated

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

Wird ausgelöst, wenn über das geprüfte Fenster eine neue Seite aufgerufen wird

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (url: string)=>void

    • url

      String

onRequestFinished

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

Wird ausgelöst, wenn eine Netzwerkanfrage abgeschlossen ist und alle Anfragedaten verfügbar sind.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (request: Request)=>void