Back to Content

Request: referrerPolicy property

files/en-us/web/api/request/referrerpolicy/index.md

latest1.0 KB
Original Source

{{APIRef("Fetch API")}}{{AvailableInWorkers}}

The referrerPolicy read-only property of the {{domxref("Request")}} interface returns the referrer policy, which governs what referrer information, sent in the {{HTTPHeader("Referer")}} header, should be included with the request.

Value

A string representing the request's referrerPolicy. For more information and possible values, see the {{HTTPHeader("Referrer-Policy")}} HTTP header page.

Examples

In the following snippet, we create a new request using the {{domxref("Request.Request", "Request()")}} constructor (for an image file in the same directory as the script), then save the request referrer policy in a variable:

js
const myRequest = new Request("flowers.jpg");
const myReferrer = myRequest.referrerPolicy; // returns "" by default

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also