Response: redirect() static 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 redirect() static method of the Response interface returns a Response resulting in a redirect to the specified URL.

Note: This can be used alongside the ServiceWorker API. A controlling service worker could intercept a page's request and redirect it as desired. This will actually lead to a real redirect if a service worker sends it upstream.

Syntax

js
Response.redirect(url)
Response.redirect(url, status)

Parameters

url

The URL that the new response is to originate from.

status Optional

An optional number indicating the status code for the response: one of 301, 302, 303, 307, or 308. If omitted, 302 Found is used by default.

Return value

A Response object.

Exceptions

RangeError

The specified status is not a redirect status.

TypeError

The specified URL is invalid.

Examples

js
Response.redirect("https://www.example.com", 302);

Specifications

Specification
Fetch Standard
# ref-for-dom-response-redirect①

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
redirect() static method

Legend

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

Full support
Full support

See also