browser.devtools.network

Beschreibung

Verwenden Sie die chrome.devtools.network API, um die Informationen zu Netzwerkanfragen abzurufen, die von den Entwicklertools im Netzwerkbereich angezeigt werden.

Informationen zu Netzwerkanfragen werden im HTTP-Archivformat (HAR) dargestellt. Die Beschreibung von HAR würde den Rahmen dieses Dokuments sprengen. Weitere Informationen finden Sie in der HAR v1.2-Spezifikation.

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

Aus Effizienzgründen wird der Inhalt der Anfrage nicht als Teil der HAR-Datei bereitgestellt. Sie können die Methode getContent() der Anfrage aufrufen, um Inhalte abzurufen.

Wenn das Fenster mit den 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 zu erhalten. Im Allgemeinen sollte die von getHAR() zurückgegebene Liste der Anfragen mit der im Netzwerkbereich angezeigten Liste übereinstimmen.

Eine allgemeine Einführung in die Verwendung von Entwicklertool-APIs finden Sie in der Zusammenfassung der Entwicklertool-APIs.

Manifest

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

"devtools_page"

Beispiele

Mit dem folgenden Code werden die URLs aller Bilder mit einer Größe von mehr als 40 KB protokolliert, während sie geladen werden:

browser.devtools.network.onRequestFinished.addListener(
  function(request) {
    if (request.response.bodySize > 40*1024) {
      browser.devtools.inspectedWindow.eval(
          'console.log("Large image: " + unescape("' +
          escape(request.request.url) + '"))');
    }
  }
);

Wenn Sie diese API ausprobieren möchten, installieren Sie die DevTools API-Beispiele aus dem Repository chrome-extension-samples.

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: 

    () => {...}

    • Gibt zurück

      Promise<object>

      Chrome 151+ browser.* seit Chrome 152

      Eine Funktion, die den Antworttext empfängt, wenn die Anfrage abgeschlossen ist.

Methoden

getHAR()

browser.devtools.network.getHAR(): Promise<object>

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

Ausgabe

  • Promise<object>

    Chrome 151+ browser.* seit Chrome 152

    Eine Funktion, die das HAR-Protokoll empfängt, wenn die Anfrage abgeschlossen ist.

Ereignisse

onNavigated

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

Wird ausgelöst, wenn das geprüfte Fenster zu einer neuen Seite wechselt.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (url: string) => void

    • URL

      String

onRequestFinished

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (request: Request) => void