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 Eigenschaft
HTMLAreaElement.referrerPolicy
spiegelt das HTML-Attribut referrerpolicy des
<area>-Elements wider, das 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 wird keine Referrer- Information zusammen mit 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), wird jedoch nicht an ein weniger sicheres Ziel gesendet (z.B. HTTPS→HTTP).
origin-
Nur der Ursprung des Dokuments wird in allen Fällen als Referrer gesendet. Das Dokument
https://example.com/page.htmlwird den Referrerhttps://example.com/senden. origin-when-cross-origin-
Sendet eine vollständige URL bei einer Anfrage, die vom selben Ursprung kommt, sendet jedoch nur den Ursprung des Dokuments in anderen Fällen.
same-origin-
Ein Referrer wird für gleichartige Ursprünge gesendet, jedoch enthalten Anfragen zwischen unterschiedlichen Ursprüngen keine Referrer-Informationen.
strict-origin-
Sendet nur den Ursprung des Dokuments als Referrer, wenn das Sicherheitsniveau des Protokolls gleich bleibt (z.B. HTTPS→HTTPS), sendet ihn jedoch nicht an ein weniger sicheres Ziel (z.B. HTTPS→HTTP).
strict-origin-when-cross-origin(Standard)-
Dies ist das Standardverhalten des Benutzeragents, wenn keine Richtlinie angegeben ist. Sendet eine vollständige URL bei einer Anfrage vom selben Ursprung, sendet jedoch 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 vollständige URL bei Anfragen vom selben Ursprung oder zwischen unterschiedlichen Ursprüngen. Diese Richtlinie wird Ursprünge und Pfade von TLS-geschützten Ressourcen an unsichere Ursprünge weitergeben. Überlegen 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 |