HTMLLinkElement:referrerPolicy 属性
referrerPolicy
属性是 HTMLLinkElement
接口的属性,它反映了 HTML referrerpolicy
属性,该属性用于定义在获取资源时发送哪个推荐来源。
有关详细信息,请参阅 HTTP Referrer-Policy
标头。
值
字符串;以下之一
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
(默认值)-
如果未指定任何策略,则这是用户代理的默认行为。在执行同源请求时发送完整 URL,仅在协议安全级别保持不变(例如 HTTPS→HTTPS)时发送来源,并向安全性较低的目的地(例如 HTTPS→HTTP)发送无标头。
unsafe-url
-
在执行同源或跨源请求时发送完整 URL。此策略会将来自 TLS 保护资源的来源和路径泄漏到不安全的来源。请仔细考虑此设置的影响。
示例
js
const links = document.getElementsByTagName("link");
links[0].referrerPolicy; // "no-referrer"
规范
规范 |
---|
HTML 标准 # dom-link-referrerpolicy |
浏览器兼容性
BCD 表格仅在启用了 JavaScript 的浏览器中加载。