HTMLScriptElement : 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 septembre 2020.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
La propriété referrerPolicy de l'interface HTMLScriptElement reflète l'attribut HTML referrerpolicy de l'élément HTML <script>, qui définit comment le référent est défini lors de la récupération du script et de tous les scripts qu'il importe.
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 le même (par exemple HTTP→HTTP, HTTPS→HTTPS), mais n'est pas envoyée vers une destination moins sécurisée (par exemple, HTTPS→HTTP).
origin-
Seule l'origine du document est envoyée comme référent dans tous les cas. Le document
https://exemple.com/page.htmlenverra le référenthttps://exemple.com/. origin-when-cross-origin-
Envoie une 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 inter-origines 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 le même (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(par défaut)-
Il s'agit du comportement par défaut de l'agent utilisateur si aucune politique n'est spécifiée. Envoie une URL complète lors d'une requête de même origine, envoie uniquement l'origine lorsque le niveau de sécurité du protocole reste le même (par exemple, HTTPS→HTTPS), et n'envoie aucun en-tête vers une destination moins sécurisée (par exemple, HTTPS→HTTP).
unsafe-url-
Envoie une URL complète lors d'une requête de même origine ou inter-origines. Cette politique divulguera les origines et les chemins des ressources protégées par TLS vers des origines non sécurisées. Considérez attentivement l'impact de ce paramètre.
Note :
Une valeur de chaîne vide ("") est à la fois la valeur par défaut et la valeur de repli si referrerpolicy n'est pas pris en charge. Si
referrerpolicy n'est pas explicitement défini sur l'élément
<script>, il adoptera une politique de référent de niveau supérieur,
c'est-à-dire celle définie sur l'ensemble du document ou du domaine. Si une politique de niveau supérieur n'est pas
disponible, la chaîne vide est traitée comme équivalente à
no-referrer-when-downgrade.
Exemples
const scriptElem = document.createElement("script");
scriptElem.src = "/";
scriptElem.referrerPolicy = "unsafe-url";
document.body.appendChild(scriptElem);
Spécifications
| Specification |
|---|
| HTML # dom-script-referrerpolicy |
Compatibilité des navigateurs
Chargement…
Voir aussi
- La propriété
HTMLIFrameElement.referrerPolicy