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 ist (nicht über einen Link, sondern zum Beispiel durch die Nutzung 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 anfänglich auf das href des Elternteil-Window.location bei Same-Origin-Anfragen gesetzt. Bei Cross-Origin-Anfragen ist es standardmäßig der origin des Elternteil-Window.location. Für weitere Informationen siehe die Dokumentation zur Referrer-Policy: strict-origin-when-cross-origin.
Beispiele
Das folgende Beispiel wird einen String mit dem Referrer des Dokuments protokollieren.
console.log(document.referrer);
Wenn der Benutzer über einen Link wie <a href="https://www.w3.org/">W3</a> auf die Seite navigiert hat, wird die vorherige Domain wie developer.mozilla.org ausgegeben. Wenn der Benutzer direkt zur Seite navigiert ist, wird ein leerer String ausgegeben.
Spezifikationen
| Specification |
|---|
| HTML # dom-document-referrer-dev |