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

View in English Always switch to English

network.fetchError-Ereignis

Das Ereignis network.fetchError des Moduls network wird ausgelöst, wenn eine Anfrage mit einem Fehler endet, beispielsweise weil der Host nicht erreichbar ist oder die Anfrage abgebrochen wird.

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.

errorText

Ein String, der den Fehler beschreibt, etwa NS_ERROR_UNKNOWN_HOST oder net::ERR_NAME_NOT_RESOLVED, wenn ein Hostname nicht aufgelöst werden kann. Der Text ist browserspezifisch. Verlassen Sie sich bei Assertions in Tests daher nicht auf diesen Wert.

isBlocked

Ein boolescher Wert, der angibt, ob die Anfrage durch einen Intercept blockiert wird. Bei diesem Ereignis ist er immer false, da für das Ereignis keine Intercept-Phase gilt. Daher enthält das Ereignis niemals das Feld intercepts.

Ein String mit der UUID, die die Navigation, zu der die Anfrage gehört, eindeutig identifiziert, oder null, wenn die Anfrage keine Navigationsanfrage ist. Beispielsweise ist der Wert null, wenn Unterressourcen eines Dokuments wie Stylesheets und Skripte angefordert werden oder wenn eine Anfrage mit fetch() gestellt wird.

Bei einer fehlgeschlagenen Navigation enthält dieses Feld die Navigations-ID, die vom Ereignis browsingContext.navigationStarted gemeldet wurde.

Wenn die Navigation mit browsingContext.navigate gestartet wurde, kann der Befehl statt einer Navigations-ID einen Fehler zurückgeben.

Andere Ereignisse im Zusammenhang mit dieser Navigation verwenden dieselbe Navigations-ID, darunter Ereignisse der Module browsingContext und network.

redirectCount

Eine nicht negative Ganzzahl mit der Anzahl der Weiterleitungen, denen der Browser für diese Anfrage gefolgt ist. Für die ursprüngliche 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 mit der Größe des Anfrage-Bodys in Byte oder null, wenn die Anfrage keinen Body hat.

cookies

Ein Array von 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.

expiry Optional

Eine nicht negative Ganzzahl mit dem Ablaufzeitpunkt des Cookies in Sekunden seit der Epoche. Bei einem Cookie ohne Ablaufzeitpunkt, beispielsweise einem Sitzungscookie, fehlt dieses Feld.

httpOnly

Ein boolescher Wert, der angibt, ob das Cookie durch sein HttpOnly-Attribut vor 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 SameSite-Einstellung des Cookies angibt. Er hat einen der folgenden Werte:

  • default: Das Cookie hat kein SameSite-Attribut oder einen nicht erkannten Wert. Daher gilt das Standardverhalten des Browsers.
  • lax: Das Cookie hat SameSite=Lax.
  • none: Das Cookie hat SameSite=None.
  • strict: Das Cookie hat SameSite=Strict.
secure

Ein boolescher Wert, der angibt, ob das Cookie durch sein Secure-Attribut auf sichere Verbindungen beschränkt ist (true) oder auch über unsichere Verbindungen gesendet werden kann (false).

size

Eine nicht negative Ganzzahl mit der Gesamtgröße von Name und Wert des Cookies in Byte.

value

Ein Objekt mit dem Wert des Cookies. Es enthält die folgenden Felder:

type

Ein String, der angibt, wie der Cookie-Wert kodiert ist. Er hat einen der folgenden Werte:

  • base64: Der Wert besteht aus Base64-kodierten Bytes, weil die Bytes kein gültiges UTF-8 sind.
  • string: Der Wert ist Text, der aus UTF-8-Bytes dekodiert wurde.
value

Ein String mit dem Cookie-Wert in der durch das Feld type angegebenen Kodierung.

destination

Ein String mit dem Ziel der Anfrage, beispielsweise document, script oder style. Bei Anfragen mit fetch() oder XMLHttpRequest ist der String leer.

headers

Ein Array von Objekten, die jeweils einen Header der Anfrage darstellen, einschließlich der mit dem Befehl network.setExtraHeaders hinzugefü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:

type

Ein String, der angibt, wie der Header-Wert kodiert ist. Er hat einen der folgenden Werte:

  • base64: Der Wert besteht aus Base64-kodierten Bytes, weil die Bytes kein gültiges UTF-8 sind.
  • string: Der Wert ist Text, der aus UTF-8-Bytes dekodiert wurde.
value

Ein String mit dem Header-Wert in der durch das Feld type angegebenen Kodierung.

headersSize

Eine nicht negative Ganzzahl mit der Größe der Anfrage-Header in Byte. Bei Protokollen, die Header komprimieren, beispielsweise HTTP/2, gibt sie die komprimierte Größe an.

initiatorType

Ein String, der angibt, wodurch die Anfrage ausgelöst wurde, beispielsweise fetch, link oder script. Bei einer Anfrage ohne Initiatortyp, etwa der Anfrage für eine in einem Tab geladene Seite, ist der Wert null statt eines Strings. Beschreibungen häufiger Werte finden Sie unter PerformanceResourceTiming.initiatorType.

method

Ein String mit der HTTP-Anfragemethode, beispielsweise GET oder POST.

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 stattgefunden haben. Das Feld timeOrigin enthält einen Zeitpunkt in Millisekunden seit der Epoche. Die anderen Felder dieses Objekts enthalten Zeitangaben in Millisekunden relativ zu timeOrigin. Ein Feld hat den Wert 0, wenn die entsprechende Phase nicht stattgefunden hat, beispielsweise die Weiterleitungsfelder bei einer Anfrage, die nicht weitergeleitet wurde. Alle Felder haben den Wert 0, 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 Domainnamens abgeschlossen hat, ähnlich wie PerformanceResourceTiming.domainLookupEnd.

dnsStart

Eine Zahl, die den Zeitpunkt angibt, zu dem der Browser mit der Auflösung des Domainnamens 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 begonnen hat, ä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 begonnen hat, ä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.

timestamp

Eine nicht negative Ganzzahl, die den Zeitpunkt angibt, zu dem das Ereignis ausgelöst wurde, in Millisekunden seit der Epoche.

userContext Optional

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 ist dies das letzte Ereignis einer fehlgeschlagenen Anfrage. Es kann jederzeit nach network.beforeRequestSent ausgelöst werden, beispielsweise:

  • Bevor eine Antwort eintrifft, wenn der Browser den Hostnamen nicht auflösen kann oder der Server die Verbindung ablehnt
  • Nach network.responseStarted, wenn die Seite die Anfrage abbricht, während der Browser noch den Antwort-Body empfängt, beispielsweise mit einem AbortSignal

Wenn der Client beide Ereignisse abonniert hat, empfängt er network.beforeRequestSent vor network.fetchError, selbst wenn die Anfrage fehlschlägt, bevor sie gesendet wird. Dieses Ereignis hat kein Feld response, auch wenn network.responseStarted für die Anfrage ausgelöst wurde.

Wenn eine Navigation fehlschlägt, können Sie die Navigations-ID dieses Ereignisses verwenden, um es dem entsprechenden Ereignis browsingContext.navigationStarted zuzuordnen.

Beispiele

Ein Ereignis empfangen, wenn ein Host nicht erreichbar ist

Angenommen, Sie haben eine WebDriver-BiDi-Verbindung, eine aktive Sitzung und ein Abonnement für network.fetchError.

Ein Tab hat https://example.com/ geladen. Die Seite ruft fetch("https://unknown.invalid/items") auf. Die Domain .invalid kann nicht aufgelöst werden, sodass die Anfrage fehlschlägt. Der Browser sendet das folgende Ereignis (der Kürze halber wurde das Array headers gekürzt und einige Felder im Objekt request wurden weggelassen):

json
{
  "type": "event",
  "method": "network.fetchError",
  "params": {
    "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
    "errorText": "NS_ERROR_UNKNOWN_HOST",
    "isBlocked": false,
    "navigation": null,
    "redirectCount": 0,
    "request": {
      "cookies": [],
      "destination": "",
      "headers": [
        {
          "name": "Host",
          "value": {
            "type": "string",
            "value": "unknown.invalid"
          }
        },
        {
          "name": "Accept",
          "value": {
            "type": "string",
            "value": "*/*"
          }
        },
        {
          "name": "Origin",
          "value": {
            "type": "string",
            "value": "https://example.com"
          }
        }
      ],
      "headersSize": 326,
      "initiatorType": "fetch",
      "method": "GET",
      "request": "b9e201af-6475-4bea-a174-51a8290f8087",
      "url": "https://unknown.invalid/items"
    },
    "timestamp": 1791903586722,
    "userContext": "default"
  }
}

errorText beschreibt die fehlgeschlagene Auflösung des Domainnamens. Auf der Seite wird der fetch()-Aufruf mit einem TypeError zurückgewiesen.

Ein Ereignis empfangen, wenn eine Navigation fehlschlägt

Angenommen, Sie verwenden dieselbe Verbindung, Sitzung und dasselbe Abonnement wie im ersten Beispiel und haben außerdem browsingContext.navigationStarted abonniert.

Sie verwenden browsingContext.navigate, um https://example.com:59999/ zu laden. Auf diesem Port lauscht kein Server.

Der Browser sendet ein browsingContext.navigationStarted-Ereignis mit der Navigations-ID:

json
{
  "type": "event",
  "method": "browsingContext.navigationStarted",
  "params": {
    "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
    "navigation": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "timestamp": 1791903594250,
    "url": "https://example.com:59999/",
    "userContext": "default"
  }
}

Wenn der Server die Verbindung ablehnt, sendet der Browser das folgende network.fetchError-Ereignis mit derselben Navigations-ID (nur einige Felder sind dargestellt):

json
{
  "type": "event",
  "method": "network.fetchError",
  "params": {
    "context": "93ee5bd6-d256-4608-a002-9a8995cc0e5f",
    "errorText": "NS_ERROR_CONNECTION_REFUSED",
    "isBlocked": false,
    "navigation": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
    "redirectCount": 0,
    "request": {
      "destination": "document",
      "method": "GET",
      "request": "37cf22b4-f399-4450-828d-d54fce56004e",
      "url": "https://example.com:59999/"
    },
    "timestamp": 1791903594254
  }
}

Der Befehl browsingContext.navigate gibt einen unknown error ohne Navigations-ID zurück. Um dieses Ereignis der Navigation zuzuordnen, verwenden Sie die ID im Feld navigation des Ereignisses browsingContext.navigationStarted.

Spezifikationen

Spezifikation
WebDriver BiDi
# event-network-fetchError

Browser-Kompatibilität

Siehe auch