HTMLImageElement: 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 September 2020.
* Some parts of this feature may have varying levels of support.
The referrerPolicy property of the HTMLImageElement interface defining which referrer is sent when fetching the resource. It reflects the <img> element's referrerpolicy content attribute.
Value
A string whose value is one of no-referrer, no-referrer-when-downgrade, origin, origin-when-cross-origin, same-origin, strict-origin, strict-origin-when-cross-origin, or unsafe-url. For their meanings, see the HTML <img> reference.
Examples
js
const img = new Image();
img.src = "img/logo.png";
img.referrerPolicy = "origin";
const div = document.getElementById("divAround");
div.appendChild(img); // Fetch the image using the origin as the referrer
Specifications
| Specification |
|---|
| HTML # dom-img-referrerpolicy |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
referrerPolicy
|
|
|
|
|
|
|
|
|
|
|
|
|
|
no-referrer-when-downgrade
|
|
|
|
|
|
|
|
|
|
|
|
|
|
origin-when-cross-origin
|
|
|
|
|
|
|
|
|
|
|
|
|
|
unsafe-url
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Uses a non-standard name
- Has more compatibility info.