Response: redirect() static method
{{APIRef("Fetch API")}}{{AvailableInWorkers}}
The redirect() static method of the {{domxref("Response")}}Response interface returns a Response resulting in a redirect to the specified URL.
[!NOTE]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_inline}}- : An optional number indicating the status code for the response: one of
{{HTTPStatus("301"301,"301")}}302,{{HTTPStatus("302"303,"302")}}, {{HTTPStatus("303", "303")}}, {{HTTPStatus("307", "307")}}307, or{{HTTPStatus("308", "308")}}308. If omitted,{{HTTPStatus("302", "302Found")}}Found is used by default.
- : An optional number indicating the status code for the response: one of
Return value
A {{domxref("Response")}}Response object.
Exceptions
{{jsxref("RangeError")}}RangeError- : The specified status is not a redirect status.
{{jsxref("TypeError")}}TypeError- : The specified URL is invalid.
Examples
Response.redirect("https://www.example.com", 302);
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}