HTMLAnchorElement: referrerPolicy 属性
基线 广泛可用
此功能已得到充分确立,并在许多设备和浏览器版本中均可正常工作。它从 2021 年 9 月.
报告反馈
值
HTMLAnchorElement.referrerPolicy
属性反映 HTML referrerpolicy
属性,该属性定义在获取资源时发送哪个引用程序。
一个字符串;以下内容之一
-
no-referrer
将完全省略
Referer
标头。不会随请求一起发送任何引用程序信息。-
no-referrer-when-downgrade
origin
-
当协议安全级别保持不变时(例如,HTTP→HTTP、HTTPS→HTTPS),将 URL 作为引用程序发送,但不会发送到安全性较低的目的地(例如,HTTPS→HTTP)。
Only send the origin of the document as the referrer in all cases. The document
https://example.com/page.html
will send the referrerhttps://example.com/
.-
origin-when-cross-origin
在执行相同来源请求时发送完整 URL,但在其他情况下仅发送文档的来源。
-
same-origin
对于 相同站点来源,将发送引用程序,但跨来源请求将不包含任何引用程序信息。
-
strict-origin
- 只有当协议安全级别保持不变时(例如,HTTPS→HTTPS),才会将文档的来源作为引用程序发送,但不会发送到安全性较低的目的地(例如,HTTPS→HTTP)。
如果未指定任何策略,这是用户代理的默认行为。在执行相同来源请求时发送完整 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://mdn.org.cn/en-US/";
elt.referrerPolicy = "no-referrer";
const div = document.getElementById("divAround");
div.appendChild(elt); // When clicked, the link will not send a referrer header.
规范
js |
---|
规范 # HTML 标准 |
浏览器兼容性
dom-a-referrerpolicy