Request: referrerPolicy property

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Note: This feature is available in Web Workers.

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

Value

A string representing the request's referrerPolicy. For more information and possible values, see the Referrer-Policy HTTP header page.

Examples

In the following snippet, we create a new request using the 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

Specification
Fetch Standard
# ref-for-dom-request-referrerpolicy②

Browser compatibility

BCD tables only load in the browser

See also