Response: redirect() static method

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