Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Modul network

Das Modul network enthält Befehle und Ereignisse zum Überwachen und Steuern der Netzwerkanfragen und -antworten des Browsers.

Anfragen

In WebDriver BiDi hat jede Netzwerkanfrage des Browsers eine Anfrage-ID. Dazu gehören Anfragen für eine Seite oder ihre Unterressourcen wie Stylesheets und Skripte sowie Anfragen, die ein Skript mit fetch() ausführt. Jedes Ereignis im Modul network, das sich auf eine Anfrage bezieht, enthält diese ID im Feld request seines request-Objekts. Sie können anhand dieser ID Ereignisse derselben Anfrage zuordnen.

Eine Anfrage, die im Rahmen einer Navigation ein Dokument in einen Kontext lädt, hat eine Navigations-ID. Dazu gehört auch die Anfrage für eine Navigation, die mit browsingContext.navigate gestartet wurde. Diese ID stimmt mit der Navigations-ID der browsingContext-Ereignisse derselben Navigation überein, beispielsweise browsingContext.navigationStarted. Anfragen für Unterressourcen des Dokuments haben für navigation den Wert null.

Lebenszyklus einer Anfrage

Um die Ereignisse zu empfangen, abonnieren Sie sie mit session.subscribe. Während eine Anfrage verarbeitet wird, sendet der Browser die folgenden Ereignisse in dieser Reihenfolge:

  1. network.beforeRequestSent wird ausgelöst, bevor der Browser die Anfrage über das Netzwerk sendet oder sie aus seinem Cache verarbeitet.
  2. network.responseStarted wird ausgelöst, sobald der Browser die Antwort-Header empfangen hat.
  3. network.responseCompleted wird ausgelöst, sobald der Browser den gesamten Antwort-Body empfangen hat.

Wenn der Server eine Authentifizierung verlangt, sendet der Browser nach network.responseStarted außerdem network.authRequired. Schlägt die Anfrage zu irgendeinem Zeitpunkt fehl, etwa weil der Host nicht erreichbar ist oder die Seite die Anfrage abbricht, während der Antwort-Body empfangen wird, sendet der Browser network.fetchError. Dies ist das letzte Ereignis im Lebenszyklus der Anfrage.

Antwortet der Server mit einer Weiterleitung, sendet der Browser für die Weiterleitungsantwort network.responseStarted und network.responseCompleted und anschließend für die neue URL network.beforeRequestSent. Alle Ereignisse für die ursprüngliche und die neue URL haben dieselbe Anfrage-ID. Das Feld redirectCount erhöht sich mit jeder Weiterleitung um eins.

Intercepts

Ein Client kann Anfragen oder Antworten mit Intercepts blockieren, die sich mit dem Befehl network.addIntercept zur Sitzung hinzufügen lassen. Wenn eine Anfrage einem Intercept entspricht, blockiert der Browser die Anfrage oder Antwort in einer Phase, die der Intercept abdeckt, sofern der Client das zugehörige Ereignis abonniert hat (etwa network.beforeRequestSent oder network.responseStarted). Im Ereignis für diese Phase ist isBlocked auf true gesetzt; außerdem enthält die Ereignisnutzlast die IDs der passenden Intercepts. Der Browser wartet dann, bis der Client die Fortsetzung der Anfrage zulässt, beispielsweise mit dem Befehl network.continueRequest.

Befehle

Ereignisse

Spezifikationen

Spezifikation
WebDriver BiDi
# module-network

Browser-Kompatibilität