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 type-Schreibgeschützte Eigenschaft der Response-Schnittstelle enthält den Typ der Antwort. Der Typ bestimmt, ob Skripte auf den Antwortkörper und die Header zugreifen können.

Wert

Ein String, der einen der folgenden Werte annehmen kann:

basic

Dies gilt in einem der folgenden Fälle:

  • Die Anfrage ist gleich-origin.
  • Das Schema der angeforderten URL ist data:.
  • Der mode der Anfrage ist navigate oder websocket.

Bei diesem Typ sind alle Antwortheader sichtbar, außer Set-Cookie.

cors

Die Anfrage war cross-origin und wurde erfolgreich unter Verwendung von CORS verarbeitet. Bei diesem Typ sind nur CORS-sicher gelistete Antwortheader sichtbar.

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 bei einem Aufruf von fetch() zurückgegeben, da bei einem Netzwerkfehler das Versprechen zurückgewiesen 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 Basic-Antwort

Die folgende gleich-origin Anfrage wird eine basic-Antwort zurückgeben:

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

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

Eine CORS-Antwort

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

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

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

Eine Opaque-Antwort

Die folgende Anfrage wird mit der no-cors-Option gestellt, daher gibt sie 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 Fehler-Antwort

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

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