W3cubDocs

/Web APIs

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⁩.

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①>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`redirect_static`	44	16	39	31	10.1	44	39	32	10.3	4.0	44	10.3