HTMLImageElement.referrerPolicy

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

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.

浏览器兼容性

BCD tables only load in the browser

相关