HTMLAreaElement: referrerPolicy 属性

值

一个字符串；以下选项之一

no-referrer

将完全省略 Referer 标头。请求不会附带任何 Referer 信息。

no-referrer-when-downgrade

当协议安全级别保持不变时（例如 HTTP→HTTP，HTTPS→HTTPS），URL 将作为 Referer 发送，但不会发送到安全性较低的目的地（例如 HTTPS→HTTP）。

origin

在所有情况下，仅将文档的 origin 作为 Referer 发送。文档 https://example.com/page.html 将发送 Referer https://example.com/。

origin-when-cross-origin

在执行同源请求时发送完整的 URL，但在其他情况下仅发送文档的 origin。

same-origin

对于 同站点（same-site）的 origin，将发送 Referer，但跨站（cross-origin）请求将不包含任何 Referer 信息。

strict-origin

当协议安全级别保持不变时（例如 HTTPS→HTTPS），仅将文档的 origin 作为 Referer 发送，但不会发送到安全性较低的目的地（例如 HTTPS→HTTP）。

strict-origin-when-cross-origin (默认)

如果未指定策略，这是用户代理的默认行为。在执行同源请求时发送完整 URL，仅在协议安全级别保持不变时发送 origin（例如 HTTPS→HTTPS），并且不向安全性较低的目的地发送标头（例如 HTTPS→HTTP）。

unsafe-url

在执行同源或跨域请求时发送完整 URL。此策略会将受 TLS 保护资源的 origin 和路径泄露给不安全的 origin。请仔细考虑此设置的影响。

示例

<img usemap="#mapAround" width="100" height="100" src="/img/logo@2x.png" />
<map id="myMap" name="mapAround"></map>

const elt = document.createElement("area");
elt.href = "/img2.png";
elt.shape = "rect";
elt.referrerPolicy = "no-referrer";
elt.coords = "0,0,100,100";
const map = document.getElementById("myMap");

map.appendChild(elt);
// When clicked, the area's link will not send a referrer header.

规范

浏览器兼容性

另见

• HTMLImageElement.referrerPolicy、HTMLAnchorElement.referrerPolicy 和 HTMLIFrameElement.referrerPolicy。