Document: referrer-Eigenschaft

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die Document.referrer-Eigenschaft gibt die URI der Seite zurück, die auf diese Seite verlinkt hat.

Wert

Der Wert ist ein leerer String, wenn der Benutzer direkt zur Seite navigiert hat (nicht durch einen Link, sondern zum Beispiel durch die Verwendung eines Lesezeichens). Da diese Eigenschaft nur einen String zurückgibt, erhalten Sie keinen Zugriff auf das Document Object Model (DOM) der verweisenden Seite.

Innerhalb eines <iframe> wird Document.referrer zunächst auf das href der Eltern-Window.location bei Same-Origin-Anfragen gesetzt. Bei Cross-Origin-Anfragen ist es standardmäßig der origin der Eltern-Window.location. Für weitere Informationen siehe die Dokumentation zur Referrer-Policy: strict-origin-when-cross-origin.

Beispiele

Das folgende Beispiel protokolliert einen String, der den Referrer des Dokuments enthält.

js
console.log(document.referrer);

Wenn der Benutzer über einen Link wie <a href="https://www.w3.org/">W3</a> zur Seite navigiert hat, wird die vorherige Domain wie developer.mozilla.org ausgegeben. Wenn der Benutzer direkt zur Seite navigiert hat, wird ein leerer String ausgegeben.

Spezifikationen

Specification
HTML Standard
# dom-document-referrer-dev

Browser-Kompatibilität

BCD tables only load in the browser