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

BCD tables only load in the browser

See also