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
Candidate Recommendation Added the referrer attribute.

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

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 来开启。

相关链接

文档标签和贡献者

此页面的贡献者: ziyunfei
最后编辑者: ziyunfei,