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 October 2017.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.

Please take two minutes to fill out our short survey.

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

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

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

Specifications

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