HTMLScriptElement: referrerPolicy-Eigenschaft

Baseline Weitgehend verfgbar *

Diese Funktion ist gut etabliert und funktioniert auf vielen Gerten und in vielen Browserversionen. Sie ist seit September 2020 browserbergreifend verfgbar.

* Einige Teile dieser Funktion werden mglicherweise unterschiedlich gut untersttzt.

Mehr erfahren
Vollstndige Kompatibilitt anzeigen

Die referrerPolicy-Eigenschaft der HTMLScriptElement-Schnittstelle spiegelt die HTML-referrerpolicy des <script>-Elements wider, welche definiert, wie der Referrer beim Abrufen des Skripts und der von ihm importierten Skripte festgelegt wird.

Wert

Ein String; einer der folgenden:

no-referrer: Der Referer-Header wird vollstndig weggelassen. Es wird keine Referrer-Information mit den Anfragen gesendet.
no-referrer-when-downgrade: Die URL wird als Referrer gesendet, wenn das Protokollsicherheitsniveau gleich bleibt (z. B. HTTPHTTP, HTTPSHTTPS), aber nicht an ein weniger sicheres Ziel gesendet wird (z. B. HTTPSHTTP).
origin: Nur der Ursprung des Dokuments wird in allen Fllen als Referrer gesendet. Das Dokument https://example.com/page.html wird den Referrer https://example.com/ senden.
origin-when-cross-origin: Eine vollstndige URL wird bei Anfragen mit gleichem Ursprung gesendet, jedoch nur der Ursprung des Dokuments fr andere Flle.
same-origin: Ein Referrer wird fr same-site origins gesendet, aber bei Anfragen mit einem anderen Ursprung werden keine Referrer-Informationen enthalten sein.
strict-origin: Nur der Ursprung des Dokuments wird als Referrer gesendet, wenn das Protokollsicherheitsniveau gleich bleibt (z. B. HTTPSHTTPS), aber nicht an ein weniger sicheres Ziel gesendet wird (z. B. HTTPSHTTP).
strict-origin-when-cross-origin (Standard): Dies ist das Standardverhalten des Benutzeragenten, wenn keine Richtlinie angegeben ist. Eine vollstndige URL wird bei Anfragen mit gleichem Ursprung gesendet, nur der Ursprung wird gesendet, wenn das Protokollsicherheitsniveau gleich bleibt (z. B. HTTPSHTTPS), und es wird kein Header an ein weniger sicheres Ziel gesendet (z. B. HTTPSHTTP).
unsafe-url: Eine vollstndige URL wird bei Anfragen mit gleichem oder anderem Ursprung gesendet. Diese Richtlinie wird Ursprnge und Pfade von TLS-geschtzten Ressourcen zu unsicheren Ursprngen preisgeben. berlegen Sie sich die Auswirkungen dieser Einstellung sorgfltig.

Hinweis: Ein leerer String-Wert ("") ist sowohl der Standardwert als auch ein Fallback-Wert, wenn referrerpolicy nicht untersttzt wird. Wenn referrerpolicy nicht explizit am <script>-Element angegeben ist, wird eine umfassendere Referrer-Richtlinie bernommen, d.h. eine, die auf das gesamte Dokument oder die Domain festgelegt wurde. Wenn keine umfassendere Richtlinie verfgbar ist, wird der leere String als gleichwertig zu no-referrer-when-downgrade angesehen.

Beispiele

const scriptElem = document.createElement("script");
scriptElem.src = "/";
scriptElem.referrerPolicy = "unsafe-url";
document.body.appendChild(scriptElem);

Spezifikationen

Spezifikation
HTML # dom-script-referrerpolicy

Browser-Kompatibilitt

Siehe auch

HTMLIFrameElement.referrerPolicy

Help improve MDN

War diese bersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen knnen Diese Seite wurde automatisch aus dem Englischen bersetzt.

bersetzung auf GitHub anzeigen Fehler mit dieser bersetzung melden

HTML DOM API
HTMLScriptElement
Instanzeigenschaften
Statische Methoden
1. supports()
Vererbung
Verwandte Seiten fr HTML DOM
Anleitungen
1. Verwenden von Microtasks in JavaScript mit queueMicrotask()
2. Im Detail: Microtasks und die JavaScript-Laufzeitumgebung