HTMLImageElement.referrerPolicy

这篇翻译不完整。请帮忙从英语翻译这篇文章

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

HTMLImageElement.referrerPolicy 反映了 <img> 元素的HTML属性 referrerpolicy 的定义,这个属性定义了<img> 元素在获取资源时的引用方式。

语法

refStr = imgElt.referrerPolicy;
imgElt.referrerPolicy = refStr;

  • "no-referrer" 表示HTTP头部信息将不会发送 referrer
  • "origin" 表示 referrer 只包含策略、主机名、端口等页面源的信息。
  • "unsafe-url" 这意味着引用者将包括源站和路径(但不包括片段、密码或用户名)。这种情况是不安全的,因为它可能会泄漏路径信息,这些信息已被使用TLS隐藏到第三方。

例子

var img = new Image();
img.src = 'img/logo.png'; 
img.referrerPolicy = 'origin';

var div = document.getElementById('divAround');
div.appendChild(img); // Fetch the image using the origin as the referrer

规范

Specification Status Comment
Referrer Policy
referrerPolicy attribute
Candidate Recommendation Added the referrerPolicy property.

浏览器兼容性

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 51 ? 50.0 (50.0) [1] ? 38 ?
Feature Android Webview Chrome for Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 51 51 50.0 (50.0) [1] ? ? ?

[1] 从火狐45到50,这都是在network.http.enableperelementerfer首选项之后。从火狐42到44,这个属性被称为referer。

相关

文档标签和贡献者

此页面的贡献者: shanLan, mdnwebdocs-bot, Ahhaha233
最后编辑者: shanLan,