HTMLIFrameElement: browsingTopics property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Non-standard: This feature is not standardized. We do not recommend using non-standard features in production, as they have limited browser support, and may change or be removed. However, they can be a suitable alternative in specific cases where no standard option exists.

Warning: This feature is currently opposed by two browser vendors. See the Standards positions section for details of opposition.

The browsingTopics property of the HTMLIFrameElement interface is a boolean specifying that the selected topics for the current user should be sent with the request for the associated <iframe>'s source in a Sec-Browsing-Topics header. This reflects the browsingtopics HTML attribute.

See Using the Topics API for more details.

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

Log the browsingTopics value via script:

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

Set

Specify a minimum <iframe>:

html

<iframe> ... </iframe>

Set browsingtopics to true then load the <iframe> contents via script:

const iframeElem = document.querySelector("iframe");
iframeElem.browsingTopics = true;
iframeElem.title = "Advertising container";
iframeElem.src = "ad-tech1.example";