HTMLAreaElement : propriété referrerPolicy
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 avril 2021.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
La propriété referrerPolicy reflète l'attribut HTML referrerpolicy de l'élément <area>, qui définit quel référent est envoyé lors de la récupération de la ressource.
Valeur
Une chaîne de caractères ; l'une des suivantes :
no-referrer-
L'en-tête
Referersera totalement omis. Aucune information de référent n'est envoyée avec les requêtes. no-referrer-when-downgrade-
L'URL est envoyée comme référent lorsque le niveau de sécurité du protocole reste identique (par exemple HTTP→HTTP, HTTPS→HTTPS), mais n'est pas envoyée vers une destination moins sécurisée (par exemple, HTTPS→HTTP).
origin-
Envoie uniquement l'origine du document comme référent dans tous les cas. Le document
https://exemple.fr/page.htmlenverra le référenthttps://exemple.fr/. origin-when-cross-origin-
Envoie l'URL complète lors d'une requête de même origine, mais envoie uniquement l'origine du document dans les autres cas.
same-origin-
Un référent sera envoyé pour les origines de même site, mais les requêtes d'origine croisée ne contiendront aucune information de référent.
strict-origin-
Envoie uniquement l'origine du document comme référent lorsque le niveau de sécurité du protocole reste identique (par exemple, HTTPS→HTTPS), mais ne l'envoie pas vers une destination moins sécurisée (par exemple, HTTPS→HTTP).
strict-origin-when-cross-origin(default)-
Il s'agit du comportement par défaut de l'agent utilisateur si aucune politique n'est définie. La chaîne de caractères complète de l'URL est envoyée lors d'une requête de même origine, seule l'origine est envoyée lorsque le niveau de sécurité du protocole reste identique (par exemple, HTTPS→HTTPS), et aucun en-tête n'est envoyé vers une destination moins sécurisée (par exemple, HTTPS→HTTP).
unsafe-url-
Envoie la chaîne de caractères complète de l'URL lors d'une requête de même origine ou d'origine croisée. Cette politique divulguera les origines et chemins des ressources protégées par TLS vers des origines non sécurisées. Réfléchissez bien à l'impact de ce paramètre.
Exemples
<img usemap="#my-map" width="100" height="100" src="/img/logo@2x.png" />
<map id="my-map" name="my-map"></map>
const elt = document.createElement("area");
elt.href = "/img2.png";
elt.shape = "rect";
elt.referrerPolicy = "no-referrer";
elt.coords = "0,0,100,100";
const map = document.getElementById("my-map");
map.appendChild(elt);
// Lors du clic, le lien de la zone n'enverra pas d'en-tête référent.
Spécifications
| Specification |
|---|
| HTML # dom-area-referrerpolicy |
Compatibilité des navigateurs
Voir aussi
- La propriété
HTMLImageElement.referrerPolicy, - La propriété
HTMLAnchorElement.referrerPolicy - La propriété
HTMLIFrameElement.referrerPolicy