CKTIS / HTML
referrerpolicy — Referrer-Informationen steuern
Das Attribut referrerpolicy legt fest, wie viele Informationen über die Adresse der verweisenden Seite ein Browser bei Navigationen oder beim Laden von Ressourcen im Referer-Header senden darf. Es gilt für ein bestimmtes Element; es ist weder ein globales Attribut noch eine CORS-Einstellung.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
referrerpolicy="no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|same-origin|strict-origin|strict-origin-when-cross-origin|unsafe-url"referrerpolicy ist ein enumeriertes Attribut für a, area, img, iframe, script und link. Es steuert die Informationen im HTTP-Header Referer – dessen Name behält absichtlich seine historische Schreibweise. Bei a und area gilt es für Navigationen, bei img für das Laden von Bildern, bei iframe für die Frame-Navigation und bei link für das Laden und Verarbeiten einer externen Ressource.
Werte: no-referrer lässt den Header weg; same-origin sendet die Adresse nur an denselben Origin; origin sendet nur den Origin; origin-when-cross-origin sendet innerhalb desselben Origins die Adresse und andernorts nur den Origin. Ein Origin besteht aus Schema, Host und Port; es bedeutet nicht einfach dieselbe Domain. „Adresse“ bezeichnet hier die URL ohne Fragment und Anmeldedaten, kann aber weiterhin Pfad und Abfrageparameter enthalten.
no-referrer-when-downgrade sendet die Adresse, außer beim Wechsel von einem sicheren zu einem weniger sicheren Kontext, etwa HTTPS → HTTP. strict-origin sendet nur den Origin und lässt ihn bei einem solchen Downgrade weg. strict-origin-when-cross-origin sendet innerhalb desselben Origins die Adresse, zwischen Origins nur den Origin und bei einem solchen Downgrade nichts. unsafe-url sendet die Adresse auch bei einem Downgrade: Dadurch können vertrauliche Pfade und Abfrageparameter offengelegt werden.
Ein fehlendes Attribut, eine leere Zeichenfolge und ein unbekannter Wert bedeuten jeweils den leeren Policy-Zustand, nicht no-referrer; es gilt die vom Dokumentkontext bereitgestellte Policy. rel="noreferrer" hat Vorrang vor der Policy eines Hyperlinks. Bei script umfasst die Einstellung den anfänglichen Abruf und Modulimporte, einschließlich import(), aber keine gewöhnlichen fetch()-Aufrufe im Code. Das Attribut gewährt weder CORS-Berechtigungen noch deaktiviert es Cookies.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Per-link referrer policy</title>
</head>
<body>
<p><a id="private-link" href="#destination" referrerpolicy="no-referrer">Destination with no referrer</a></p>
<p><a id="default-link" href="#destination">Destination without a policy override</a></p>
<p id="destination">Destination</p>
<script>
const privateLink = document.getElementById('private-link');
const defaultLink = document.getElementById('default-link');
for (const link of [privateLink, defaultLink]) {
for (const type of ['click', 'auxclick']) {
link.addEventListener(type, event => event.preventDefault());
}
}
console.log('Explicit link policy: ' + privateLink.referrerPolicy);
console.log('Other link policy override: ' + JSON.stringify(defaultLink.referrerPolicy));
</script>
</body>
</html>Ergebnis
Explicit link policy: no-referrer Other link policy override: ""
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.