Ereignis network.responseStarted
Das Ereignis network.responseStarted des Moduls network wird ausgelöst, wenn der Browser die Header einer Antwort empfangen hat, aber noch nicht den vollständigen Antworttext.
Ereignisdaten
Das Feld params in der Ereignisbenachrichtigung ist ein Objekt mit den folgenden Feldern:
context-
Ein String mit der ID des Kontexts, in dem die Anfrage gestellt wurde, oder
null, wenn die Anfrage nicht von einem Dokument in einem Kontext gestellt wurde, beispielsweise bei einer Anfrage durch einen Worker. interceptsOptional-
Ein Array aus einem oder mehreren Strings, die jeweils die ID eines Intercepts enthalten, der die Antwort blockiert. Dieses Feld ist nur enthalten, wenn
isBlockedden Werttruehat. Intercept-IDs werden vom Befehlnetwork.addInterceptzurückgegeben. isBlocked-
Ein boolescher Wert, der angibt, ob die Antwort durch einen Intercept blockiert wird.
true: Die Antwort entspricht einem oder mehreren der im Feldinterceptsaufgeführten Intercepts und wird blockiert. Der Browser verarbeitet die Antwort erst weiter, wenn der Client sie fortsetzt, beispielsweise mit dem Befehlnetwork.continueResponse.false: Die Antwort entspricht keinem Intercept der Sitzung. Der Client muss sie daher nicht fortsetzen.
-
Ein String mit der UUID, die die Navigation, zu der die Anfrage gehört, eindeutig identifiziert, oder
null, wenn es sich nicht um eine Navigationsanfrage handelt. Beispielsweise ist der Wertnull, wenn Unterressourcen eines Dokuments wie Stylesheets und Skripte angefordert werden oder eine Anfrage mitfetch()gestellt wird. Wenn die Navigation mit dem BefehlbrowsingContext.navigateoderbrowsingContext.reloadgestartet wurde, entspricht diese ID dem Wertnavigationin der Antwort des Befehls. Andere Ereignisse im Zusammenhang mit dieser Navigation haben dieselbe Navigations-ID, darunter Ereignisse der ModulebrowsingContextundnetwork. redirectCount-
Eine nicht negative Ganzzahl, die angibt, wie vielen Weiterleitungen der Browser für diese Anfrage gefolgt ist. Bei der ursprünglichen Anfrage ist der Wert
0; mit jeder Weiterleitung erhöht er sich um eins. request-
Ein Objekt, das die Anfrage beschreibt. Es enthält die folgenden Felder:
bodySize-
Eine nicht negative Ganzzahl, die die Größe des Anfragekörpers in Byte angibt, oder
null, wenn die Anfrage keinen Körper hat. -
Ein Array aus Objekten, die jeweils ein mit der Anfrage gesendetes Cookie darstellen. Das Array ist leer, wenn die Anfrage keinen
Cookie-Header hat. Jedes Objekt enthält die folgenden Felder und kann zusätzlich browserspezifische Felder enthalten:domain-
Ein String mit der Domain des Cookies.
expiryOptional-
Eine nicht negative Ganzzahl, die den Ablaufzeitpunkt des Cookies in Sekunden seit der Epoche angibt. Dieses Feld fehlt bei Cookies ohne Ablaufzeitpunkt, etwa Sitzungscookies.
httpOnly-
Ein boolescher Wert, der angibt, ob das Cookie durch sein Attribut
HttpOnlyvor Seitenskripten verborgen ist (true) oder ob diese darauf zugreifen können (false). name-
Ein String mit dem Namen des Cookies.
path-
Ein String mit dem Pfad des Cookies.
sameSite-
Ein String, der die Einstellung
SameSitedes Cookies angibt. Er hat einen der folgenden Werte:default: Das Cookie hat kein AttributSameSiteoder dessen Wert wird nicht erkannt. Daher gilt das Standardverhalten des Browsers.lax: Das Cookie hatSameSite=Lax.none: Das Cookie hatSameSite=None.strict: Das Cookie hatSameSite=Strict.
secure-
Ein boolescher Wert, der angibt, ob das Cookie durch sein Attribut
Secureauf sichere Verbindungen beschränkt ist (true) oder auch über unsichere Verbindungen gesendet werden kann (false). size-
Eine nicht negative Ganzzahl, die die Gesamtgröße des Cookie-Namens und -Werts in Byte angibt.
value-
Ein Objekt mit dem Wert des Cookies. Es enthält die folgenden Felder:
destination-
Ein String mit dem Ziel der Anfrage, beispielsweise
document,scriptoderstyle. Bei Anfragen mitfetch()oderXMLHttpRequestist der String leer. headers-
Ein Array aus Objekten, die jeweils einen Header der Anfrage darstellen, einschließlich der mit dem Befehl
network.setExtraHeadershinzugefügten Header. Jedes Objekt enthält die folgenden Felder:name-
Ein String mit dem Header-Namen, beispielsweise
Accept. value-
Ein Objekt mit dem Header-Wert. Es enthält die folgenden Felder:
headersSize-
Eine nicht negative Ganzzahl, die die Größe der Anfrage-Header in Byte angibt. Bei Protokollen, die Header komprimieren, etwa HTTP/2, gibt sie die komprimierte Größe an.
initiatorType-
Ein String, der angibt, wodurch die Anfrage ausgelöst wurde, beispielsweise
fetch,linkoderscript. Bei einer Anfrage ohne Initiatortyp, etwa der Anfrage für eine in einem Tab geladene Seite, ist der Wertnullstatt eines Strings. Beschreibungen gängiger Werte finden Sie unterPerformanceResourceTiming.initiatorType. method-
Ein String mit der HTTP-Anfragemethode, beispielsweise
GEToderPOST. request-
Ein String mit der ID der Anfrage. Die ID bleibt auch dann gleich, wenn die Anfrage weitergeleitet wird.
timings-
Ein Objekt mit den Zeitpunkten, zu denen die einzelnen Phasen der Anfrage stattfanden. Das Feld
timeOriginenthält einen Zeitpunkt in Millisekunden seit der Epoche. Die anderen Felder dieses Objekts enthalten Zeitangaben in Millisekunden relativ zutimeOrigin. Ein Feld hat den Wert0, wenn seine Phase nicht stattgefunden hat, beispielsweise die Weiterleitungsfelder bei einer Anfrage, die nicht weitergeleitet wurde. Alle Felder haben den Wert0, wenn die Anfrage nicht von einem Dokument oder Worker gestellt wurde. Das Objekt enthält die folgenden Felder:connectEnd-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser den Verbindungsaufbau zum Server abgeschlossen hat, ähnlich wie
PerformanceResourceTiming.connectEnd. connectStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser mit dem Verbindungsaufbau zum Server begonnen hat, ähnlich wie
PerformanceResourceTiming.connectStart. dnsEnd-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser die Auflösung des Domain-Namens abgeschlossen hat, ähnlich wie
PerformanceResourceTiming.domainLookupEnd. dnsStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser mit der Auflösung des Domain-Namens begonnen hat, ähnlich wie
PerformanceResourceTiming.domainLookupStart. fetchStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser nach etwaigen Weiterleitungen mit dem Abrufen der Ressource begonnen hat, ähnlich wie
PerformanceResourceTiming.fetchStart. redirectEnd-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser das letzte Byte der Antwort auf die letzte Weiterleitung empfangen hat, ähnlich wie
PerformanceResourceTiming.redirectEnd. redirectStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem die später weitergeleitete Anfrage ursprünglich gestartet wurde, ähnlich wie
PerformanceResourceTiming.redirectStart. requestStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser mit dem Senden der Anfrage begonnen hat, ähnlich wie
PerformanceResourceTiming.requestStart. requestTime-
Eine Zahl, die den Zeitpunkt angibt, zu dem die Anfrage gestartet wurde, ähnlich wie
PerformanceEntry.startTime. responseEnd-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser das letzte Byte der Antwort empfangen hat, ähnlich wie
PerformanceResourceTiming.responseEnd. responseStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser das erste Byte der Antwort empfangen hat, ähnlich wie
PerformanceResourceTiming.responseStart. timeOrigin-
Eine Zahl, die den Zeitursprung des Dokuments oder Workers angibt, von dem die Anfrage gestellt wurde.
tlsStart-
Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser den TLS-Handshake zur Absicherung der Verbindung begonnen hat, ähnlich wie
PerformanceResourceTiming.secureConnectionStart.
url-
Ein String mit der URL der Anfrage.
response-
Ein Objekt, das die Antwort beschreibt. Es enthält die folgenden Felder:
authChallengesOptional-
Ein Array aus Objekten, die jeweils eine Authentifizierungsaufforderung des Servers darstellen. Dieses Feld ist nur enthalten, wenn der Antwortstatus
401oder407ist. Die Aufforderungen stammen bei401-Antworten aus dem HeaderWWW-Authenticateund bei407-Antworten aus dem HeaderProxy-Authenticate. Das Array ist leer, wenn die Antwort den entsprechenden Header nicht enthält. Jedes Objekt enthält die folgenden Felder:realm-
Ein String mit dem Realm der Aufforderung oder ein leerer String, wenn die Aufforderung keinen Realm hat.
scheme-
Ein String mit dem Authentifizierungsschema, beispielsweise
Basic.
bodySize-
Eine nicht negative Ganzzahl, die die Größe des Antwortkörpers in Byte angibt, bevor der Browser ihn dekodiert (beispielsweise vor der Dekomprimierung), oder
null, wenn der Browser sie nicht meldet. Wenn dieses Ereignis ausgelöst wird, ist der Antwortkörper möglicherweise noch nicht vollständig eingetroffen. Die endgültige Größe ist daher im Ereignisnetwork.responseCompletedverfügbar. bytesReceived-
Eine nicht negative Ganzzahl, die die Gesamtzahl der für die Antwort empfangenen Bytes einschließlich ihrer Header angibt. Bei einer Antwort aus dem Browser-Cache ist der Wert
0. content-
Ein Objekt, das den dekodierten Antwortkörper beschreibt. Es enthält das folgende Feld:
size-
Eine nicht negative Ganzzahl, die die Größe des Antwortkörpers in Byte angibt, nachdem der Browser ihn dekodiert hat (beispielsweise nach der Dekomprimierung).
fromCache-
Ein boolescher Wert, der angibt, ob der Browser die Antwort aus seinem Cache bereitgestellt hat.
true: Der Browser hat die Antwort aus seinem Cache bereitgestellt, ohne den Server zu kontaktieren.false: Der Browser hat die Antwort nicht aus seinem Cache bereitgestellt. Dies schließt Fälle ein, in denen er den Server kontaktiert hat, um eine zwischengespeicherte Antwort erneut zu validieren.
headers-
Ein Array aus Objekten, die jeweils einen Header der Antwort darstellen. Jedes Objekt enthält die folgenden Felder:
name-
Ein String mit dem Header-Namen, beispielsweise
Content-Type. value-
Ein Objekt mit dem Header-Wert. Es enthält die folgenden Felder:
headersSize-
Eine nicht negative Ganzzahl, die die Größe der empfangenen Antwort-Header in Byte angibt, oder
null, wenn der Browser sie nicht meldet. mimeType-
Ein String mit dem MIME-Typ, den der Browser für die Antwort verwendet, beispielsweise
text/htmloderapplication/json. Der Wert enthält keine MIME-Typ-Parameter. Er kann vom HeaderContent-Typeabweichen, beispielsweise wenn der Browser den Typ anhand des Inhalts bestimmt. Er kann auch ein leerer String sein, beispielsweise bei einer Weiterleitungsantwort. protocol-
Ein String mit dem Protokoll der Antwort, beispielsweise
http/1.1oderh2. Bei einer Antwort, die nicht über HTTP empfangen wurde, enthält er das Schema der Antwort-URL, beispielsweisedata. status-
Eine nicht negative Ganzzahl mit dem HTTP-Statuscode der Antwort, beispielsweise
200. statusText-
Ein String mit der Statusmeldung der Antwort, beispielsweise
OK. url-
Ein String mit der URL der Antwort.
timestamp-
Eine nicht negative Ganzzahl, die den Zeitpunkt der Ereignisauslösung in Millisekunden seit der Epoche angibt.
userContextOptional-
Ein String mit der ID des Benutzerkontexts, in dem die Anfrage gestellt wurde, oder
null, wenn die Anfrage nicht von einem Dokument in einem Kontext gestellt wurde.
Beschreibung
Im Lebenszyklus einer Anfrage wird dieses Ereignis nach network.beforeRequestSent und vor network.responseCompleted ausgelöst. Letzteres wird ausgelöst, wenn der Browser den vollständigen Antwortkörper empfangen hat.
Das Ereignis wird auch bei Weiterleitungsantworten und bei Antworten aus dem Browser-Cache ausgelöst.
Wenn die Anfrage nach diesem Ereignis fehlschlägt, beispielsweise weil die Seite sie abbricht, wird das Ereignis network.fetchError ausgelöst.
Bei einer Antwort, die eine Authentifizierung verlangt, kann anschließend das Ereignis network.authRequired ausgelöst werden.
Zu diesem Zeitpunkt enthält das Objekt response den Status und die Header. Die Felder, die den Antwortkörper beschreiben, etwa bodySize, bytesReceived und content, haben jedoch möglicherweise noch nicht ihre endgültigen Werte.
Wenn isBlocked den Wert true hat, wartet die Antwort, bis der Client sie mit dem Befehl network.continueResponse, network.failRequest oder network.provideResponse fortsetzt.
Abhängig von den für jeden Intercept konfigurierten Phasen kann der Browser eine Antwort beim Auslösen von network.responseStarted blockieren, unabhängig davon, ob er die Anfrage beim Auslösen von network.beforeRequestSent blockiert hat.
Er kann die Anfrage auch beim Auslösen von network.beforeRequestSent blockieren, ohne die Antwort beim Auslösen von network.responseStarted zu blockieren.
Beispiele
>Ein Ereignis beim Eintreffen der Antwort-Header empfangen
Angenommen, Sie verfügen über eine WebDriver-BiDi-Verbindung, eine aktive Sitzung und ein Abonnement für network.responseStarted.
Ein Tab hat https://example.com/ geladen.
Der Browser hat für die Website ein Cookie namens theme=dark.
Die Seite ruft fetch("/api/items") auf, um eine Liste von Elementen als JSON zu laden.
Wenn die Antwort-Header eintreffen, sendet der Browser das folgende Ereignis (der Kürze halber wurde das Array headers im Objekt request gekürzt und einige seiner Felder wurden weggelassen):
{
"type": "event",
"method": "network.responseStarted",
"params": {
"context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
"isBlocked": false,
"navigation": null,
"redirectCount": 0,
"request": {
"cookies": [
{
"domain": "example.com",
"httpOnly": false,
"name": "theme",
"path": "/",
"sameSite": "lax",
"secure": false,
"size": 9,
"value": {
"type": "string",
"value": "dark"
}
}
],
"destination": "",
"headers": [
{
"name": "Host",
"value": {
"type": "string",
"value": "example.com"
}
},
{
"name": "Accept",
"value": {
"type": "string",
"value": "*/*"
}
}
],
"headersSize": 401,
"initiatorType": "fetch",
"method": "GET",
"request": "b9e201af-6475-4bea-a174-51a8290f8087",
"url": "https://example.com/api/items"
},
"response": {
"bodySize": 0,
"bytesReceived": 188,
"content": {
"size": 0
},
"fromCache": false,
"headers": [
{
"name": "Cache-Control",
"value": {
"type": "string",
"value": "no-store"
}
},
{
"name": "Content-Type",
"value": {
"type": "string",
"value": "application/json"
}
},
{
"name": "Date",
"value": {
"type": "string",
"value": "Tue, 13 Oct 2026 14:58:02 GMT"
}
},
{
"name": "Connection",
"value": {
"type": "string",
"value": "keep-alive"
}
},
{
"name": "Keep-Alive",
"value": {
"type": "string",
"value": "timeout=5"
}
},
{
"name": "Transfer-Encoding",
"value": {
"type": "string",
"value": "chunked"
}
}
],
"headersSize": 188,
"mimeType": "application/json",
"protocol": "http/1.1",
"status": 200,
"statusText": "OK",
"url": "https://example.com/api/items"
},
"timestamp": 1791903482441,
"userContext": "default"
}
}
Zu diesem Zeitpunkt hat der Browser die Antwort-Header empfangen, aber nicht unbedingt den Antwortkörper.
Die endgültigen Werte für bytesReceived und die Größen des Antwortkörpers stehen im Objekt response des Ereignisses network.responseCompleted mit derselben request-ID.
Ein Ereignis für eine Antwort aus dem Cache empfangen
Angenommen, die Seite ruft mit derselben Verbindung, Sitzung und demselben Abonnement wie im ersten Beispiel dieselbe URL zweimal ab.
Der Server erlaubt dem Browser, die Antwort eine Stunde lang zwischenzuspeichern (Cache-Control: max-age=3600).
Bei der zweiten Anfrage stellt der Browser die Antwort aus seinem Cache bereit und sendet das folgende Ereignis (nur einige Felder sind dargestellt):
{
"type": "event",
"method": "network.responseStarted",
"params": {
"context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
"isBlocked": false,
"navigation": null,
"redirectCount": 0,
"request": {
"request": "37cf22b4-f399-4450-828d-d54fce56004e",
"url": "https://example.com/api/categories"
},
"response": {
"bytesReceived": 0,
"fromCache": true,
"status": 200,
"url": "https://example.com/api/categories"
},
"timestamp": 1791903483454
}
}
Im Objekt response ist fromCache gleich true und bytesReceived gleich 0, da nichts vom Server empfangen wurde.
Spezifikationen
| Spezifikation |
|---|
| WebDriver BiDi> # event-network-responseStarted> |
Browser-Kompatibilität
Siehe auch
- Ereignis
network.beforeRequestSent - Ereignis
network.responseCompleted - Ereignis
network.fetchError - Ereignis
network.authRequired - Befehl
session.subscribe - Referenz zu HTTP-Antwortstatuscodes