WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen