HTMLAnchorElement.referrer

这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

HTMLAnchorElement.referrer 属性对应于 HTML 中 <a> 标签的 referrer 属性,它可以控制用户在点击这个链接时所发出的 HTTP 请求的 Referer 请求头的值。

语法

refStr = anchorElt.referrer;
anchorElt.referrer = refStr;

属性值

  • "no-referrer" 意味着不要发送 Referer 请求头。
  • "origin"  意味着所发送的 Referer 请求头的值为当前页面的源,即 location.origin 的值。
  • "unsafe-url" 意味着所发送的 Referrer 请求头的值为当前页面完整的 url(即 location.href)去掉尾部的哈希(即 location.hash)之后的值。正如该选项的名字所言(unsafe),此选项是不安全的,它可以将一个 HTTPS 页面的路径信息透露给第三方。

示例

var elt = document.createElement("a");
var linkText = document.createTextNode("My link");
elt.appendChild(linkText);
elt.href = "https://developer.mozilla.org/en-US/";
elt.referrer = "no-referrer";
var div = document.getElementById("divAround");
div.appendChild(elt); // 点击该链接接时不会发送 Referer 请求头

规范

Specification Status Comment
Referrer Policy
referrer attribute
Working Draft Added the referrer attribute.

浏览器兼容性

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support ? ? 42.0 (42.0) [1] ? ? ?
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support ? 42.0 (42.0) [1] ? ? ?

[1] 该特性目前默认为关闭状态,请通过将 network.http.enablePerElementReferrer 选项设置为 true 来开启。

相关链接

文档标签和贡献者