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
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.
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