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 istnavigate
oderwebsocket
.
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 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 bei einem Aufruf vonfetch()
zurückgegeben, da bei einem Netzwerkfehler das Versprechen zurückgewiesen 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 Basic-Antwort
Die folgende gleich-origin Anfrage wird eine basic
-Antwort zurückgeben:
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:
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:
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:
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① |