大网数据广告活动
Web 标准与前端开发

HTMLLinkElement:referrerPolicy 属性

· 52CE 我爱测

HTMLLinkElement 接口的 **`referrerPolicy`** 属性反映 link 元素的 HTML `referrerpolicy` 属性,该属性定义获取资源时发送哪个来源地址。

HTML DOM

HTMLLinkElement 接口的 referrerPolicy 属性反映 link 元素的 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 保护的资源的源和路径泄露给不安全的源。请仔细考虑此设置的影响。

示例

const links = document.getElementsByTagName("link");
links[0].referrerPolicy; // "no-referrer"

规范

浏览器兼容性

参见

  • HTTP 标头 Referrer-Policy
  • HTMLAnchorElement.referrerPolicy
  • HTMLAreaElement.referrerPolicy
  • HTMLIFrameElement.referrerPolicy
  • HTMLImageElement.referrerPolicy

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。