HTMLIFrameElement：browsingTopics 属性

实验性： 这是一个实验性技术
在生产环境中使用此功能前，请仔细查看浏览器兼容性表格。

非标准： 此功能是非标准的，并且不在标准跟踪中。不要在面向 Web 的生产站点上使用它：它不会对每个用户都起作用。实现之间也可能存在很大的不兼容性，并且行为将来可能会发生变化。

警告： 此功能目前受到两家浏览器供应商的反对。有关反对意见的详细信息，请参阅标准立场部分。

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

有关更多详细信息，请参阅使用主题 API。

值

布尔值。默认值为 false；将其设置为 true 以使用包含当前用户选定主题的 Sec-Browsing-Topics 标头发送关联的 <iframe> 源请求。

示例

获取

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

html

<iframe browsingtopics title="Advertising container" src="adtech1.example">
  ...
</iframe>

通过脚本记录 browsingTopics 值

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

设置

指定最小 <iframe>

html

<iframe> ... </iframe>

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

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

iframeElem.browsingTopics = true;
iframeElem.title = "Advertising container";
iframeElem.src = "adtech1.example";

规范

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

主题 API