在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

HTMLIFrameElement .referrerPolicy property reflects the HTML referrerpolicy 属性在 <iframe> element defining which referrer is sent when fetching the resource.

句法

refStr = iframeElt.referrerPolicy;
iframeElt.referrerPolicy = refStr;
					

值

no-referrer

Referer header will be omitted entirely. No referrer information is sent along with requests.

no-referrer-when-downgrade (default)

This is the user agent's default behavior if no policy is specified. The URL is sent as a referrer when the protocol security level stays the same (HTTP→HTTP, HTTPS→HTTPS), but isn't sent to a less secure destination (HTTPS→HTTP).

origin

Only send the origin of the document as the referrer in all cases.
The document https://example.com/page.html will send the referrer https://example.com/ .

origin-when-cross-origin

Send a full URL when performing a same-origin request, but only send the origin of the document for other cases.

same-origin

A referrer will be sent for same-site origins , but cross-origin requests will contain no referrer information.

strict-origin

Only send the origin of the document as the referrer when the protocol security level stays the same (HTTPS→HTTPS), but don't send it to a less secure destination (HTTPS→HTTP).

strict-origin-when-cross-origin

Send a full URL when performing a same-origin request, only send the origin when the protocol security level stays the same (HTTPS→HTTPS), and send no header to a less secure destination (HTTPS→HTTP).

unsafe-url

Send a full URL when performing a same-origin or cross-origin request. This policy will leak origins and paths from TLS-protected resources to insecure origins. Carefully consider the impact of this setting.

范例

var iframe = document.createElement("iframe");
iframe.src = "/";
iframe.referrerPolicy = "unsafe-url";
var body = document.getElementsByTagName("body")[0];
body.appendChild(iframe); // Fetch the image using the complete URL as the referrer
					

规范

规范	状态	注释
Referrer Policy The definition of 'referrerpolicy attribute' in that specification.	候选推荐	添加 referrerPolicy 属性。
HTML 实时标准 The definition of 'HTMLIFrameElement: referrerPolicy' in that specification.	实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
referrerPolicy	Chrome 51	Edge 79	Firefox 50	IE No	Opera 38	Safari 11.1	WebView Android 51	Chrome Android 51	Firefox Android 50	Opera Android 41	Safari iOS No	Samsung Internet Android 5.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

• HTMLAnchorElement.referrerPolicy , HTMLAreaElement.referrerPolicy ，和 HTMLAreaElement.referrerPolicy .

元数据

• 最后修改： Mar 18, 2019

相关话题

1. HTMLIFrameElement
2. 特性

   1. allowPaymentRequest
   2. contentWindow
   3. csp
   4. featurePolicy
   5. referrerPolicy
3. 方法

   1. setNfcFocus()
4. 继承：

   1. HTMLElement
   2. 元素
   3. 节点
   4. EventTarget