Response: type-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die schreibgeschützte type-Eigenschaft der Response-Schnittstelle enthält den Typ der Antwort. Der Typ bestimmt, ob Skripte Zugriff auf den Antwortkörper und die Header haben.

Wert

Ein String, der einen der folgenden Werte haben kann:

basic

Dies gilt in einem der folgenden Fälle:

  • Die Anfrage ist gleicher Herkunft (same-origin).
  • Das Schema der angeforderten URL ist data:.
  • Der mode der Anfrage ist navigate oder websocket.

Bei diesem Typ sind alle Antwort-Header freigegeben, außer Set-Cookie.

cors

Die Anfrage war von einer anderen Herkunft (cross-origin) und wurde erfolgreich unter Verwendung von CORS verarbeitet. Bei diesem Typ sind nur CORS-safe-listente Antwortheader freigegeben.

error

Ein Netzwerkfehler ist aufgetreten. Die status-Eigenschaft ist auf 0 gesetzt, body ist null, Header sind leer und unveränderlich.

Dies ist der Typ der Antwort, die von Response.error() zurückgegeben wird. Eine Antwort dieses Typs wird nicht von einem Aufruf von fetch() zurückgegeben, da bei einem Netzwerkfehler das Versprechen abgelehnt wird.

opaque

Eine Antwort auf eine Cross-Origin-Anfrage, deren mode auf no-cors gesetzt war. Die status-Eigenschaft ist auf 0 gesetzt, body ist null, Header sind leer und unveränderlich.

opaqueredirect

Eine Antwort auf eine Anfrage, deren redirect-Option auf manual gesetzt war und die vom Server umgeleitet wurde. Die status-Eigenschaft ist auf 0 gesetzt, body ist null, Header sind leer und unveränderlich.

Beispiele

Eine grundlegende Antwort

Die folgende Anfrage gleicher Herkunft gibt eine basic-Antwort zurück:

js
const response = await fetch("flowers.jpg");

console.log(response.type); // "basic"

Eine CORS-Antwort

Angenommen, https://example.org ist nicht die Herkunft des Anfragenden und der Server antwortet mit den entsprechenden CORS-Headern, dann wird diese Anfrage eine cors-Antwort zurückgeben:

js
const response = await fetch("https://example.org/flowers.jpg");

console.log(response.type); // "cors"

Eine nicht tranparente Antwort

Die folgende Anfrage wird mit der Option no-cors gestellt und gibt daher eine opaque-Antwort zurück:

js
const response = await fetch("https://example.org/flowers.jpg", {
  mode: "no-cors",
});

console.log(response.type); // "opaque"
console.log(response.body); // null
console.log(response.status); // 0

Eine Fehlerantwort

Der folgende Code verwendet Response.error(), um eine error-Antwort zu erstellen:

js
const response = Response.error();

console.log(response.type); // "error"
console.log(response.body); // null
console.log(response.status); // 0

Spezifikationen

Specification
Fetch
# ref-for-dom-response-type①

Browser-Kompatibilität

Siehe auch