Skip to content

index.md

Latest commit

 

History

History
66 lines (51 loc) · 3.28 KB

index.md

File metadata and controls

66 lines (51 loc) · 3.28 KB
title HTMLAreaElement : propriété referrerPolicy
short-title referrerPolicy
slug Web/API/HTMLAreaElement/referrerPolicy
l10n
sourceCommit
ca26363fcc6fc861103d40ac0205e5c5b79eb2fa

{{APIRef("HTML DOM")}}

La propriété referrerPolicy de l'interface {{DOMxRef("HTMLAreaElement")}} reflète l'attribut HTML referrerpolicy de l'élément {{HTMLElement("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 {{HTTPHeader("Referer")}} est 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.html envoie le référent https://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 est envoyé pour les origines de même site, mais les requêtes d'origine croisée ne contiennent 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 divulgue 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'envoie pas d'en-tête référent.

Spécifications

{{Specifications}}

Compatibilité des navigateurs

{{Compat}}

Voir aussi

  • La propriété {{DOMxRef("HTMLImageElement.referrerPolicy")}}
  • La propriété {{DOMxRef("HTMLAnchorElement.referrerPolicy")}}
  • La propriété {{DOMxRef("HTMLIFrameElement.referrerPolicy")}}