chrome.devtools.network

Beschreibung

Mit der chrome.devtools.network API können Sie die Informationen zu Netzwerkanfragen abrufen, die von den Entwicklertools im Netzwerkbereich angezeigt werden.

Informationen zu Netzwerkanfragen werden im HAR-Format (HTTP Archive) dargestellt. Die Beschreibung von HAR fällt nicht in den Rahmen dieses Dokuments. Weitere Informationen finden Sie in der HAR v1.2-Spezifikation.

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

Aus Effizienzgründen sind die Anfrageinhalte nicht Teil von HAR. Sie können die getContent()-Methode der Anfrage aufrufen, um Inhalte abzurufen.

Wenn das Fenster „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 sehen. Im Allgemeinen sollte die Liste der Anfragen, die von getHAR() zurückgegeben werden, mit der im Netzwerkbereich angezeigten Liste übereinstimmen.

Eine allgemeine Einführung in die Verwendung von Developer Tools APIs finden Sie unter DevTools APIs summary.

Manifest

Die folgenden Schlüssel müssen im Manifest deklariert werden, damit diese API verwendet werden kann.

"devtools_page"

Beispiele

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

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 ausprobieren möchten, installieren Sie die devtools API-Beispiele aus dem Repository chrome-extension-samples.

Typen

Request

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

Properties

  • getContent

    void

    Gibt den Inhalt des Antworttexts zurück.

    Die getContent-Funktion sieht so aus: 

    () => {...}

    • Gibt zurück

      Promise<object>

      Ausstehend

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

Methoden

getHAR()

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

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

Ausgabe

  • Promise<object>

    Ausstehend

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

Ereignisse

onNavigated

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

Wird ausgelöst, wenn das untersuchte Fenster zu einer neuen Seite wechselt.

Parameter

  • 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.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (request: Request) => void