Request

Baseline Weitgehend verfügbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2017 browserübergreifend verfügbar.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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

Die Request-Schnittstelle der Fetch API repräsentiert eine Ressourcenanfrage.

Sie können ein neues Request-Objekt mit dem Request()-Konstruktor erstellen, aber es ist wahrscheinlicher, dass Sie ein Request-Objekt als Ergebnis eines anderen API-Vorgangs erhalten, wie zum Beispiel als FetchEvent.request eines Service Workers (FetchEvent.request).

Konstruktor

Request(): Erstellt ein neues Request-Objekt.

Instanzeigenschaften

Request.body Schreibgeschützt: Ein ReadableStream des Inhalts des Körpers.
Request.bodyUsed Schreibgeschützt: Speichert true oder false, um anzuzeigen, ob der Körper in einer Anfrage bereits verwendet wurde oder nicht.
Request.cache Schreibgeschützt: Enthält den Cache-Modus der Anfrage (z.B., default, reload, no-cache).
Request.credentials Schreibgeschützt: Enthält einen Wert, der steuert, ob Anmeldedaten mit der Anfrage einbezogen werden sollen (z.B., omit, same-origin, include). Der Standardwert ist same-origin.
Request.destination Schreibgeschützt: Ein Zeichenfolgewert, der die Art des angeforderten Inhalts beschreibt.
Request.duplex Schreibgeschützt: Der Duplex-Modus der Anfrage, der bestimmt, ob der Browser die gesamte Anfrage senden muss, bevor die Antwort verarbeitet wird.
Request.headers Schreibgeschützt: Enthält das zugehörige Headers-Objekt der Anfrage.
Request.integrity Schreibgeschützt: Enthält den subresource integrity-Wert der Anfrage (z.B., sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=).
Request.isHistoryNavigation Schreibgeschützt: Ein boolescher Wert, der angibt, ob die Anfrage eine Verlaufsnavigation ist.
Request.keepalive Schreibgeschützt: Enthält die keepalive-Einstellung der Anfrage (true oder false), die angibt, ob der Browser die zugehörige Anfrage beibehalten wird, wenn die Seite, die sie initiiert hat, entladen wird, bevor die Anfrage abgeschlossen ist.
Request.method Schreibgeschützt: Enthält die Methode der Anfrage (GET, POST, etc.)
Request.mode Schreibgeschützt: Enthält den Modus der Anfrage (z.B., cors, no-cors, same-origin, navigate).
Request.redirect Schreibgeschützt: Enthält den Modus, wie Umleitungen behandelt werden. Es kann follow, error, oder manual sein.
Request.referrer Schreibgeschützt: Enthält den Referrer der Anfrage (z.B., client).
Request.referrerPolicy Schreibgeschützt: Enthält die Referrer-Richtlinie der Anfrage (z.B., no-referrer).
Request.signal Schreibgeschützt: Gibt das mit der Anfrage verbundene AbortSignal zurück.
Request.targetAddressSpace Schreibgeschützt: Gibt den Ziel-Adressraum der Anfrage zurück, der angibt, ob es sich um eine Loopback-, lokale oder öffentliche Anfrage handelt.
Request.url Schreibgeschützt: Enthält die URL der Anfrage.

Instanzmethoden

Request.arrayBuffer(): Gibt ein Promise zurück, das mit einer ArrayBuffer-Darstellung des Anfragkörpers aufgelöst wird.
Request.blob(): Gibt ein Promise zurück, das mit einer Blob-Darstellung des Anfragkörpers aufgelöst wird.
Request.bytes(): Gibt ein Promise zurück, das mit einer Uint8Array-Darstellung des Anfragkörpers aufgelöst wird.
Request.clone(): Erstellt eine Kopie des aktuellen Request-Objekts.
Request.formData(): Gibt ein Promise zurück, das mit einer FormData-Darstellung des Anfragkörpers aufgelöst wird.
Request.json(): Gibt ein Promise zurück, das mit dem Resultat des Parsens des Anfragkörpers als JSON aufgelöst wird.
Request.text(): Gibt ein Promise zurück, das mit einer Textdarstellung des Anfragkörpers aufgelöst wird.

Hinweis: Die Funktionen des Anfragkörpers können nur einmal ausgeführt werden; nachfolgende Aufrufe werden mit einem TypeError abgelehnt, der zeigt, dass der Body-Stream bereits verwendet wurde.

Beispiele

Im folgenden Ausschnitt erstellen wir eine neue Anfrage mit dem Request()-Konstruktor (für eine Bilddatei im selben Verzeichnis wie das Skript) und geben dann einige Eigenschaftenwerte der Anfrage zurück:

const request = new Request("https://www.mozilla.org/favicon.ico");

const url = request.url;
const method = request.method;
const credentials = request.credentials;

Sie könnten dann diese Anfrage abrufen, indem Sie das Request-Objekt als Parameter an einen fetch()-Aufruf übergeben, zum Beispiel:

fetch(request)
  .then((response) => response.blob())
  .then((blob) => {
    image.src = URL.createObjectURL(blob);
  });

Im folgenden Ausschnitt erstellen wir eine neue Anfrage mit dem Request()-Konstruktor mit einigen Anfangsdaten und Körperinhalt für eine API-Anfrage, die ein Body-Payload benötigt:

const request = new Request("https://example.com", {
  method: "POST",
  body: '{"foo": "bar"}',
});

const url = request.url;
const method = request.method;
const credentials = request.credentials;
const bodyUsed = request.bodyUsed;

Hinweis: Der Körper kann nur ein Blob, ein ArrayBuffer, ein TypedArray, ein DataView, ein FormData, ein URLSearchParams, ein ReadableStream oder ein String-Objekt sein, sowie ein string-Literal. Daher müssen Sie das Objekt in eine Zeichenfolge umwandeln, um ein JSON-Objekt dem Payload hinzuzufügen.

Sie könnten dann diese API-Anfrage abrufen, indem Sie das Request-Objekt als Parameter an einen fetch()-Aufruf übergeben und zum Beispiel die Antwort erhalten:

fetch(request)
  .then((response) => {
    if (response.status !== 200) {
      throw new Error("Something went wrong on API server!");
    }
    return response.json();
  })
  .then((response) => {
    console.debug(response);
    // …
  })
  .catch((error) => {
    console.error(error);
  });

Spezifikationen

Spezifikation
Fetch # request-class

Browser-Kompatibilität

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden