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: Dieses Feature ist verfügbar in Web Workers.

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 Standard
# ref-for-dom-request-clone①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch