HTMLAnchorElement:referrerPolicy 属性
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
HTMLAnchorElement.referrerPolicy
属性反映 <a>
元素的 HTML referrerpolicy
属性,该属性定义获取资源时发送哪个来源地址(referrer)。
值
一个字符串;以下值之一:
no-referrer
-
Referer
标头将被完全省略。请求中不会发送任何来源地址。 no-referrer-when-downgrade
-
当协议安全级别保持不变时(例如,HTTP → HTTP、HTTPS → HTTPS),该 URL 会作为来源地址发送,但不会发送到安全级别较低的目的地(例如,HTTPS → HTTP)。
origin
-
在所有情况下,仅将文档的来源作为来源地址发送。
https://example.com/page.html
文档将发送来源地址https://example.com/
。 origin-when-cross-origin
-
在执行同源请求时发送完整的 URL,但在其他情况下仅发送文档的来源。
same-origin
-
对于同源策略,将会发送来源地址,但跨源请求将不包含任何来源地址信息。
strict-origin
-
当协议安全级别保持不变(HTTPS → HTTPS)时仅发送文档的源作为来源地址,但不发送到安全性较低的目的地(HTTPS → HTTP)。
strict-origin-when-cross-origin
(default)-
这是用户代理未指定策略时的默认行为。执行同源请求时发送完整的 URL,仅当协议安全级别保持不变(HTTPS → HTTPS)时发送源,并且不向安全性较低的目的地(HTTPS → HTTP)发送任何标头。
unsafe-url
-
在执行同源或跨源请求时发送完整的 URL。此策略会将 TLS 保护的资源的来源和路径泄露给不安全的来源。请仔细考虑此设置的影响。
示例
const elt = document.createElement("a");
const linkText = document.createTextNode("My link");
elt.appendChild(linkText);
elt.href = "https://developer.mozilla.org/zh-CN/";
elt.referrerPolicy = "no-referrer";
const div = document.getElementById("divAround");
div.appendChild(elt); // 点击时,链接将不发送来源地址标头
规范
Specification |
---|
HTML Standard # dom-a-referrerpolicy |
浏览器兼容性
BCD tables only load in the browser