Anforderung: clone()-Methode

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 clone()-Methode der Request-Schnittstelle erstellt eine Kopie des aktuellen Request-Objekts.

Ähnlich wie die zugrunde liegende ReadableStream.tee-API wird das body einer geklonten Response den backpressure-Rückstau mit der Geschwindigkeit des schnelleren Verbrauchers der beiden Bodies signalisieren, und nicht gelesene Daten werden intern beim langsamer verbrauchten body eingereiht, ohne jegliche Begrenzung oder Rückstau. Seien Sie vorsichtig, wenn Sie einen Request aus einem Stream erstellen und ihn dann clone.

clone() wirft einen TypeError, wenn der Anforderungskörper bereits verwendet wurde. Tatsächlich existiert clone() hauptsächlich, um die mehrfache Verwendung von Body-Objekten zu ermöglichen (wenn diese nur einmal verwendet werden dürfen).

Wenn Sie beabsichtigen, die Anforderung zu ändern, ziehen Sie möglicherweise den Request-Konstruktor vor.

Syntax

js
clone()

Parameter

Keine.

Rückgabewert

Ein Request-Objekt, das eine genaue Kopie des Request ist, auf dem clone() aufgerufen 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 klonen dann die Anfrage.

js
const myRequest = new Request("flowers.jpg");
const newRequest = myRequest.clone(); // a copy of the request is now stored in newRequest

Spezifikationen

Specification
Fetch
# ref-for-dom-request-clone①

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
clone

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch