Anfrage: clone()-Methode
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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die clone()-Methode des Request-Interfaces erstellt eine Kopie des aktuellen Request-Objekts.
Ähnlich der zugrunde liegenden ReadableStream.tee-API,
wird das body eines geklonten Request
den Rückstaudruck mit der Geschwindigkeit des schnelleren Verbrauchers der beiden Bodies signalisieren,
und nicht gelesene Daten werden intern in dem langsamer konsumierten body eingereiht,
ohne Limit oder Rückstaudruck.
Vorsicht ist geboten, wenn Sie einen Request aus einem Stream konstruieren und dann clone darauf anwenden.
clone() wirft einen TypeError, wenn der Anforderungskörper bereits verwendet wurde. Tatsächlich existiert clone() hauptsächlich, um die mehrfache Verwendung von Köperobjekten zu erlauben (wenn sie nur einmal verwendet werden können).
Falls Sie vorhaben, die Anfrage zu ändern, ziehen Sie eventuell den Request-Konstruktor vor.
Syntax
clone()
Parameter
Keine.
Rückgabewert
Ein Request-Objekt, das eine exakte Kopie des Request ist, auf dem clone() aufgerufen wurde.
Beispiele
Im folgenden Ausschnitt erstellen wir eine neue Anfrage mithilfe des Request()-Konstruktors (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
| Spezifikation |
|---|
| Fetch # ref-for-dom-request-clone① |