MDN self-hosted library · e01.org

HTMLImageElement: referrerPolicy property

HTML DOM

Open notebook · 1 cells web-api-instance-property upstream source

HTML DOM

The referrerPolicy property of the HTMLImageElement interface defines 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

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

Browser compatibility

See also

  • HTMLAnchorElement.referrerPolicy
  • HTMLAreaElement.referrerPolicy
  • HTMLIFrameElement.referrerPolicy