HTMLIFrameElement:browsingTopics 属性

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

非标准:此特性未标准化。我们不建议在生产环境中使用非标准特性,因为它们浏览器支持有限,并且可能会更改或被移除。但是,在没有标准选项的特定情况下,它们可以是合适的替代方案。

警告:此功能目前受到两家浏览器厂商的反对。有关反对的详细信息,请参阅标准立场部分。

HTMLIFrameElement 接口的 browsingTopics 属性是一个布尔值,用于指定当前用户的精选主题应在与 <iframe> 关联的资源的请求中,通过 Sec-Browsing-Topics 标头发送。这反映了 browsingtopics HTML 属性。

有关更多详细信息,请参阅使用 Topics API

一个布尔值。默认值为 false;将其设置为 true,以便在请求关联的 <iframe> 资源时,包含一个包含当前用户精选主题的 Sec-Browsing-Topics 标头。

示例

获取

browsingtopics 设置为 true,然后声明式加载 <iframe> 内容

html
<iframe browsingtopics title="Advertising container" src="ad-tech1.example">
  ...
</iframe>

通过脚本记录 browsingTopics 的值

js
const iframeElem = document.querySelector("iframe");
console.log(iframeElem.browsingTopics); // will return true in supporting browsers

Set

指定一个最小的 <iframe>

html
<iframe> ... </iframe>

browsingtopics 设置为 true,然后通过脚本加载 <iframe> 内容

js
const iframeElem = document.querySelector("iframe");

iframeElem.browsingTopics = true;
iframeElem.title = "Advertising container";
iframeElem.src = "ad-tech1.example";

规范

此功能不是官方标准的一部分,尽管它在Topics API 非官方提案草案中有所说明。

浏览器兼容性

另见