CKTIS / JavaScript
Request — eine Fetch-Anfrage beschreiben
Request repräsentiert eine Anfrage für Fetch. Der Konstruktor bereitet URL, Methode, Header und einen optionalen Body vor, ohne etwas zu senden. Der Body ist ein Stream: Sein Lesen beeinflusst, ob er wiederverwendet werden kann.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
new Request(input, init?)Request ist eine Web-API aus dem Fetch Standard und kein Bestandteil von ECMAScript. new Request(input, init?) sendet nichts; übergib die Anfrage an fetch().
input akzeptiert eine URL oder ein anderes Request-Objekt; init legt Optionen wie method, headers und body fest. Die Standardmethode ist GET. Ein Body zusammen mit GET oder HEAD löst einen TypeError aus.
text() und json() verbrauchen den Body. bodyUsed zeigt an, ob der Stream des Bodys im Zustand disturbed ist, also ob daraus gelesen wurde oder der Stream abgebrochen wurde. Auch wenn du einen ungelesenen Stream abbrichst, wird bodyUsed zu true. Rufe vor dem Lesen clone() auf, um einen separaten Stream-Zweig zu erhalten; ein verbrauchter oder gesperrter Body verhindert das Klonen.
Das Beispiel verwendet kein Netzwerk: Es liest den ursprünglichen Body und den seiner Kopie aus.
Beispiele
(async () => {
const request = new Request('https://example.org/items', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ id: 7 })
});
const copy = request.clone();
console.log(request.method);
console.log(request.headers.get('content-type'));
console.log(request.bodyUsed);
console.log(await request.text());
console.log(request.bodyUsed);
console.log(await copy.text());
})().catch(console.error);Ergebnis
POST
application/json
false
{"id":7}
true
{"id":7}Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.