Dokument: referrer-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die schreibgeschützte Eigenschaft referrer der Document-Schnittstelle gibt die URI der Seite zurück, von der aus auf diese Seite verlinkt wurde.
Wert
Der Wert ist eine leere Zeichenfolge, wenn der Benutzer die Seite direkt aufgerufen hat, also nicht über einen Link, sondern beispielsweise über ein Lesezeichen. Da diese Eigenschaft nur eine Zeichenfolge zurückgibt, bietet sie keinen Zugriff auf das Document Object Model (DOM) der verweisenden Seite.
Innerhalb eines <iframe> wird Document.referrer bei Same-Origin-Anfragen zunächst auf den href-Wert von Window.location der übergeordneten Seite gesetzt. Bei Cross-Origin-Anfragen ist es standardmäßig der origin-Wert von Window.location der übergeordneten Seite. Weitere Informationen finden Sie in der Dokumentation zu Referrer-Policy: strict-origin-when-cross-origin.
Beispiele
Der folgende Code gibt eine Zeichenfolge mit dem Referrer des Dokuments in der Konsole aus.
console.log(document.referrer);
Wenn der Benutzer über einen Link wie <a href="https://www.w3.org/">W3</a> zur Seite navigiert ist, wird die vorherige Domain ausgegeben, beispielsweise developer.mozilla.org. Wenn der Benutzer die Seite direkt aufgerufen hat, wird eine leere Zeichenfolge ausgegeben.
Spezifikationen
| Spezifikation |
|---|
| HTML # dom-document-referrer-dev |