chrome.devtools.network

Beschreibung

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

Manifest

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

"devtools_page"

Eine allgemeine Einführung zur Verwendung der Entwicklertools-APIs finden Sie in der Zusammenfassung der Entwicklertools.

Übersicht

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

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

Beachten Sie, dass Anfrageinhalte aus Effizienzgründen nicht als Teil von HAR bereitgestellt werden. Unter getContent()-Methode der Anfrage zum Abrufen von Inhalten.

Wenn das Fenster der Entwicklertools geöffnet wird, nachdem die Seite geladen wurde, fehlen möglicherweise einige Anforderungen in Das von getHAR() zurückgegebene Array der Einträge. Aktualisieren Sie die Seite, um alle Anfragen zu sehen. Im Allgemeinen Die Liste der von getHAR() zurückgegebenen Anfragen muss mit der Liste im Bereich „Netzwerk“ übereinstimmen.

Beispiele

Mit dem folgenden Code werden die URLs aller Bilder beim Laden, die größer als 40 KB sind, 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) + '"))');
    }
  }
);

Um diese API auszuprobieren, installieren Sie die devtools API-Beispiele aus chrome-extension-samples zu erstellen.

Typen

Request

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

Attribute

  • getContent

    voidm

    Gibt den Inhalt des Antworttexts zurück.

    Die Funktion getContent sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

    • callback

      Funktion

      Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

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

      • Inhalt

        String

        Inhalt des Antworttexts (möglicherweise codiert)

      • encoding

        String

        Leer, wenn der Inhalt nicht codiert ist, andernfalls den Codierungsnamen. 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.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (harLog: object) => void

    • harLog

      Objekt

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

Ereignisse

onNavigated

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (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: <ph type="x-smartling-placeholder"></ph>

    (request: Request) => void