HTMLIFrameElement: browsingTopics-Eigenschaft

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Kein Standard: Diese Funktion ist nicht standardisiert und befindet sich nicht im Standardisierungsprozess. Verwenden Sie sie nicht auf Produktionsseiten, die auf das Web ausgerichtet sind: Sie wird nicht für alle Benutzer funktionieren. Außerdem kann es große Inkompatibilitäten zwischen Implementierungen geben und das Verhalten kann sich in Zukunft ändern.

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

BCD tables only load in the browser

Siehe auch