Request: clone() method

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.

Note: This feature is available in Web Workers.

The clone() method of the Request interface creates a copy of the current Request object.

Like the underlying ReadableStream.tee api, the body of a cloned Response will signal backpressure at the rate of the faster consumer of the two bodies, and unread data is enqueued internally on the slower consumed body without any limit or backpressure. Beware when you construct a Request from a stream and then clone it.

clone() throws a TypeError if the request body has already been used. In fact, the main reason clone() exists is to allow multiple uses of body objects (when they are one-use only.)

If you intend to modify the request, you may prefer the Request constructor.

Syntax

js
clone()

Parameters

None.

Return value

A Request object, which is an exact copy of the Request that clone() was called on.

Examples

In the following snippet, we create a new request using the Request() constructor (for an image file in the same directory as the script), then clone the request.

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

Specifications

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

Browser compatibility

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

See also