HTMLAreaElement: referrerPolicy-Eigenschaft
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.
* Some parts of this feature may have varying levels of support.
Die HTMLAreaElement.referrerPolicy-Eigenschaft spiegelt das HTML-Attribut referrerpolicy des <area>-Elements wider. Dieses definiert, welcher Referrer beim Abrufen der Ressource gesendet wird.
Wert
Ein String; einer der folgenden:
no-referrer-
Der
Referer-Header wird vollständig weggelassen. Es werden keine Referrer-Informationen mit den Anfragen gesendet. no-referrer-when-downgrade-
Die URL wird als Referrer gesendet, wenn das Sicherheitsniveau des Protokolls gleich bleibt (z.B. HTTP→HTTP, HTTPS→HTTPS), aber nicht an ein weniger sicheres Ziel gesendet (z.B. HTTPS→HTTP).
origin-
Sendet in allen Fällen nur den Ursprung des Dokuments als Referrer. Das Dokument
https://example.com/page.htmlsendet den Referrerhttps://example.com/. origin-when-cross-origin-
Sendet eine volle URL, wenn eine Anfrage im selben Ursprung durchgeführt wird, aber nur den Ursprung des Dokuments in anderen Fällen.
same-origin-
Ein Referrer wird für same-site origins gesendet, aber Anfragen über unterschiedliche Ursprünge hinweg enthalten keine Referrer-Informationen.
strict-origin-
Sendet nur den Ursprung des Dokuments als Referrer, wenn das Sicherheitsniveau des Protokolls gleich bleibt (z.B. HTTPS→HTTPS), aber nicht an ein weniger sicheres Ziel (z.B. HTTPS→HTTP).
strict-origin-when-cross-origin(Standard)-
Dies ist das Standardverhalten des User-Agents, wenn keine Richtlinie spezifiziert ist. Sendet eine volle URL, wenn eine Anfrage im selben Ursprung durchgeführt wird, sendet nur den Ursprung, wenn das Sicherheitsniveau des Protokolls gleich bleibt (z.B. HTTPS→HTTPS), und sendet keinen Header an ein weniger sicheres Ziel (z.B. HTTPS→HTTP).
unsafe-url-
Sendet eine volle URL bei Anfragen im selben oder über unterschiedliche Ursprünge hinweg. Diese Richtlinie kann Ursprünge und Pfade von TLS-geschützten Ressourcen an unsichere Ursprünge weitergeben. Erwägen Sie sorgfältig die Auswirkungen dieser Einstellung.
Beispiele
<img usemap="#my-map" width="100" height="100" src="/img/logo@2x.png" />
<map id="my-map" name="my-map"></map>
const elt = document.createElement("area");
elt.href = "/img2.png";
elt.shape = "rect";
elt.referrerPolicy = "no-referrer";
elt.coords = "0,0,100,100";
const map = document.getElementById("my-map");
map.appendChild(elt);
// When clicked, the area's link will not send a referrer header.
Spezifikationen
| Specification |
|---|
| HTML # dom-area-referrerpolicy |