Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

referrerpolicy — contrôler les informations de provenance

L’attribut referrerpolicy indique la quantité d’informations sur l’adresse de la page référente qu’un navigateur peut envoyer dans l’en-tête Referer lors d’une navigation ou du chargement d’une ressource. Il s’applique à un élément donné ; ce n’est ni un attribut global ni un réglage CORS.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

referrerpolicy="no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|same-origin|strict-origin|strict-origin-when-cross-origin|unsafe-url"

referrerpolicy est un attribut énuméré pour a, area, img, iframe, script et link. Il contrôle les informations envoyées dans l’en-tête HTTP Referer — le nom de cet en-tête conserve volontairement son orthographe historique. Pour a et area, il concerne la navigation ; pour img, le chargement d’une image ; pour iframe, la navigation du cadre ; et pour link, le chargement et le traitement d’une ressource externe.

Valeurs : no-referrer omet l’en-tête ; same-origin n’envoie l’adresse qu’à la même origine ; origin n’envoie que l’origine ; origin-when-cross-origin envoie l’adresse au sein de la même origine et uniquement l’origine ailleurs. Une origine comprend le schéma, l’hôte et le port ; ce n’est pas simplement le même domaine. Ici, « adresse » désigne l’URL privée de son fragment et de ses identifiants de connexion, mais qui peut encore contenir son chemin et ses paramètres de requête.

no-referrer-when-downgrade envoie l’adresse sauf lors du passage d’un contexte sécurisé à un contexte moins sécurisé, par exemple HTTPS → HTTP. strict-origin n’envoie que l’origine et l’omet lors d’un tel déclassement. strict-origin-when-cross-origin envoie l’adresse au sein de la même origine, uniquement l’origine entre origines, et rien lors d’un tel déclassement. unsafe-url envoie l’adresse même lors d’un déclassement : cela peut exposer des chemins et des paramètres de requête sensibles.

Un attribut absent, une chaîne vide et une valeur non reconnue correspondent tous à l’état de politique vide, et non à no-referrer ; la politique fournie par le contexte du document s’applique. rel="noreferrer" prend le pas sur la politique d’un lien hypertexte. Pour script, le réglage couvre le chargement initial et les imports de modules, y compris import(), mais pas les appels ordinaires à fetch() dans son code. L’attribut n’accorde pas de droits CORS et ne désactive pas les cookies.

Exemples

<!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>

Résultat

Explicit link policy: no-referrer
Other link policy override: ""

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources