HTMLLinkElement:referrerPolicy 属性

基线 广泛可用

此功能已得到良好建立,并且可在许多设备和浏览器版本中使用。它自以下时间起在浏览器中可用: 2021 年 9 月.

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 的浏览器中加载。

另请参阅