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 istnavigate
oderwebsocket
.
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 auf0
gesetzt,body
istnull
, 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 vonfetch()
zurückgegeben, da bei einem Netzwerkfehler das Versprechen abgelehnt wird. opaque
-
Eine Antwort auf eine Cross-Origin-Anfrage, deren
mode
aufno-cors
gesetzt war. Diestatus
-Eigenschaft ist auf0
gesetzt,body
istnull
, Header sind leer und unveränderlich. opaqueredirect
-
Eine Antwort auf eine Anfrage, deren
redirect
-Option aufmanual
gesetzt war und die vom Server umgeleitet wurde. Diestatus
-Eigenschaft ist auf0
gesetzt,body
istnull
, Header sind leer und unveränderlich.
Beispiele
Eine grundlegende Antwort
Die folgende Anfrage gleicher Herkunft gibt eine basic
-Antwort zurück:
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:
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:
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:
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① |