diff options
Diffstat (limited to 'files/de/web/api/response/index.html')
-rw-r--r-- | files/de/web/api/response/index.html | 120 |
1 files changed, 120 insertions, 0 deletions
diff --git a/files/de/web/api/response/index.html b/files/de/web/api/response/index.html new file mode 100644 index 0000000000..ee370f462e --- /dev/null +++ b/files/de/web/api/response/index.html @@ -0,0 +1,120 @@ +--- +title: Response +slug: Web/API/Response +translation_of: Web/API/Response +--- +<div>{{APIRef("Fetch API")}}</div> + +<p>Die <strong><code>Response</code></strong> Schnittstelle der <a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a> stellt die Antwort auf eine Anfrage dar.</p> + +<p>Sie können ein neues <code>Response</code>-Objekt mithilfe des Konstruktors {{domxref("Response.Response()")}} erstellen. Es ist jedoch wahrscheinlicher, dass Sie ein Response-Objekt als Rückgabewert einer API Operation erhalten, z. B. durch einen Service Worker {{domxref("Fetchevent.respondWith")}} oder ein simples {{domxref("GlobalFetch.fetch()")}}.</p> + +<h2 id="Konstruktor">Konstruktor</h2> + +<dl> + <dt>{{domxref("Response.Response","Response()")}}</dt> + <dd>Erstell ein neues <code>Response</code> Objekt.</dd> +</dl> + +<h2 id="Eigenschaften">Eigenschaften</h2> + +<dl> + <dt>{{domxref("Response.headers")}} {{readonlyinline}}</dt> + <dd>Enthält das {{domxref("Headers")}} Objekt der Antwort.</dd> + <dt>{{domxref("Response.ok")}} {{readonlyinline}}</dt> + <dd>Enthält einen boolschen Wert, ob die anfrage Erfolgreich war (Status im Bereich von 200-299) oder nicht.</dd> + <dt>{{domxref("Response.redirected")}} {{ReadOnlyInline}}</dt> + <dd>Gibt an, ob die Antwort das Ergebnis einer Weiterleitung ist, d. h. die URL-Liste enthält mehrere Einträge.</dd> + <dt>{{domxref("Response.status")}} {{readonlyinline}}</dt> + <dd>Enthält den Status-Code der Antwort (z. B. <code>200</code> bei Erfolg).</dd> + <dt>{{domxref("Response.statusText")}} {{readonlyinline}}</dt> + <dd>Enthält die Statusmeldung, die dem Statuscode entspricht (z. B. <code>OK</code> für <code>200</code>).</dd> + <dt>{{domxref("Response.type")}} {{readonlyinline}}</dt> + <dd>Enthält den Typ der Antwort (z. B. <code>basic</code>, <code>cors</code>).</dd> + <dt>{{domxref("Response.url")}} {{readonlyinline}}</dt> + <dd>Enthält die URL der Antwort.</dd> + <dt>{{domxref("Response.useFinalURL")}}</dt> + <dd>Enthält einen booleschen Wert, der angibt, ob dies die endgültige URL der Antwort ist.</dd> +</dl> + +<p><code>Response</code> implementiert {{domxref("Body")}}, daher stehen darüber hinaus auch folgende Eigenschaften zur Verfügung:</p> + +<dl> + <dt>{{domxref("Body.body")}} {{readonlyInline}}</dt> + <dd>Ein einfacher Getter, der verwendet wird, um einen {{domxref("ReadableStream")}} des Body-Inhalts verfügbar zu machen.</dd> + <dt>{{domxref("Body.bodyUsed")}} {{readonlyInline}}</dt> + <dd>Speichert einen {{domxref("Boolean")}}, der angibt, ob der Body bereits in einer Antwort verwendet wurde.</dd> +</dl> + +<h2 id="Methoden">Methoden</h2> + +<dl> + <dt>{{domxref("Response.clone()")}}</dt> + <dd>Klont <code>Response</code> Objekt.</dd> + <dt>{{domxref("Response.error()")}}</dt> + <dd>Gibt ein neues <code>Response</code> Objekt zurück, das einem Netzwerkfehler zugeordnet ist.</dd> + <dt>{{domxref("Response.redirect()")}}</dt> + <dd>Erstellt eine neue Antwort mit einer anderen URL.</dd> +</dl> + +<p><code>Response</code> implementiert {{domxref("Body")}}, daher stehen darüber hinaus auch folgende Methoden zur Verfügung:</p> + +<dl> + <dt>{{domxref("Body.arrayBuffer()")}}</dt> + <dd>Nimmt einen {{domxref("Response")}} Stream und liest ihn bis zum Ende. Gibt ein Promise zurück, welches in einen {{domxref("ArrayBuffer")}} aufgelöst wird.</dd> + <dt>{{domxref("Body.blob()")}}</dt> + <dd>Nimmt einen {{domxref("Response")}} Stream und liest ihn bis zum Ende. Gibt ein Promise zurück, welches in einen {{domxref("Blob")}} aufgelöst wird.</dd> + <dt>{{domxref("Body.formData()")}}</dt> + <dd>Nimmt einen {{domxref("Response")}} Stream und liest ihn bis zum Ende. Gibt ein Promise zurück, welches in einen {{domxref("FormData")}} Objekt aufgelöst wird.</dd> + <dt>{{domxref("Body.json()")}}</dt> + <dd>Nimmt einen {{domxref("Response")}} Stream und liest ihn bis zum Ende. Gibt ein Promise zurück, welches den Inhalt des Body als {{jsxref("JSON")}} einliest.</dd> + <dt>{{domxref("Body.text()")}}</dt> + <dd>Nimmt einen {{domxref("Response")}} Stream und liest ihn bis zum Ende. Gibt ein Promise zurück, welches in einen {{domxref("USVString")}} (Text) aufgelöst wird.</dd> +</dl> + +<h2 id="Beispiele">Beispiele</h2> + +<p>In unserem <a href="https://github.com/mdn/fetch-examples/tree/master/basic-fetch">grundlegenden Beispiel zu Fetch</a> (<a href="https://mdn.github.io/fetch-examples/basic-fetch/">Beispiel live ausführen</a>) verwenden wir einen einfachen Aufruf von <code>fetch()</code>, um ein Bild abzurufen und es in einem {{htmlelement("img")}} Tag anzuzeigen. Der Aufruf von <code>fetch()</code> gibt ein Promise zurück, das zu einem Response Objekt aufgelöst wird, welches mit der Anforderung der Ressource verknüpft ist. Da wir ein Bild anfordern, werden Sie feststellen, dass wir {{domxref("Body.blob")}} ausführen müssen ({{domxref("Response")}} implementiert <code>Body</code>), um der Antwort den richtigen MIME-Type zuzuordnen.</p> + +<pre class="brush: js">const image = document.querySelector('.my-image'); +fetch('flowers.jpg').then(function(response) { + return response.blob(); +}).then(function(blob) { + const objectURL = URL.createObjectURL(blob); + image.src = objectURL; +});</pre> + +<p>Sie können auch den {{domxref("Response.Response()")}} Konstruktor verwenden, um Ihr eigenes benutzerdefiniertes <code>Response</code> Objekt zu erstellen:</p> + +<pre class="brush: js">const response = new Response();</pre> + +<h2 id="Spezifikationen">Spezifikationen</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName('Fetch','#response-class','Response')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td>Initial definition</td> + </tr> + </tbody> +</table> + +<h2 id="Browserkompatibilität">Browserkompatibilität</h2> + + + +<p>{{Compat("api.Response")}}</p> + +<h2 id="Siehe_auch">Siehe auch</h2> + +<ul> + <li><a href="/de/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/de/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> + <li><a href="/de/docs/Web/HTTP">HTTP</a></li> +</ul> |