HTMLIFrameElement: browsingTopics-Eigenschaft

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.

Warnung: Dieses Feature wird derzeit von zwei Browser-Anbietern abgelehnt. Einzelheiten zur Ablehnung finden Sie im Abschnitt Standards Positionen.

Die browsingTopics-Eigenschaft des HTMLIFrameElement-Interfaces ist ein Boolean, der angibt, dass die ausgewählten Themen für den aktuellen Benutzer mit der Anforderung für die zugehörige Quelle des <iframe> in einem Sec-Browsing-Topics-Header gesendet werden sollen. Dies entspricht dem HTML-Attribut browsingtopics.

Weitere Details finden Sie unter Verwendung der Topics API.

Wert

Ein Boolean. Der Standardwert ist false; setzen Sie ihn auf true, um die zugehörige <iframe>-Quellenanfrage mit einem Sec-Browsing-Topics-Header zu senden, der die ausgewählten Themen für den aktuellen Benutzer enthält.

Beispiele

Get

Setzen Sie browsingtopics auf true und laden Sie dann den Inhalt des <iframe> deklarativ:

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

Protokollieren Sie den browsingTopics-Wert über ein Skript:

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

Set

Geben Sie ein minimales <iframe> an:

html
<iframe> ... </iframe>

Setzen Sie browsingtopics auf true und laden Sie dann den Inhalt des <iframe> über ein Skript:

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

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

Spezifikationen

Dieses Feature ist nicht Teil eines offiziellen Standards, obwohl es in dem Unofficial Proposal Draft der Topics API spezifiziert ist.

Browser-Kompatibilität

Siehe auch