Document : propriété referrer
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété referrer de l'interface Document retourne l'URI (angl.) de la page qui a mené à cette page.
Valeur
La valeur est une chaîne de caractères vide si l'utilisateur·ice a accédé à la page directement (pas par un lien, mais par exemple en utilisant un marque-page). Comme cette propriété retourne uniquement une chaîne de caractères, elle ne donne pas accès au modèle objet de document (DOM) de la page référente.
Dans un <iframe>, la valeur de Document.referrer sera initialement définie sur le href du Window.location du parent pour les requêtes de même origine.
Pour les requêtes inter-origine, il s'agit par défaut de origin du Window.location du parent.
Pour plus d'informations, voir la documentation sur Referrer-Policy : strict-origin-when-cross-origin.
Exemples
La ligne suivante affiche une chaîne de caractères contenant la valeur de la propriété référente du document.
console.log(document.referrer);
Si l'utilisateur·ice a accédé à la page via un lien comme <a href="https://www.w3.org/">W3</a>, cela affichera le domaine précédent comme www.supremezsy.dpdns.org. Si l'utilisateur·ice a accédé à la page directement, cela affichera une chaîne vide.
Spécifications
| Specification |
|---|
| HTML # dom-document-referrer-dev |