HTMLIFrameElement : propriété browsingTopics
Obsolète
En cours de suppression
Cette fonctionnalité est en cours de suppression des navigateurs. L'utiliser maintenant peut entraîner un dysfonctionnement dans les futures mises à jour. Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the topics API.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
Attention : Cette fonctionnalité est actuellement contestée par deux éditeurs de navigateurs. Voir la section Positions des standards pour plus de détails sur l'opposition.
La propriété browsingTopics de l'interface HTMLIFrameElement est un booléen indiquant que les sujets sélectionnés pour l'utilisateur·ice actuel·le doivent être envoyés avec la requête pour la source de l'élément <iframe> associé dans un en-tête Sec-Browsing-Topics. Cela reflète l'attribut HTML browsingtopics.
Voir Utiliser l'API Topics pour plus de détails.
Valeur
Un booléen. La valeur par défaut est false ; définissez-la à true pour envoyer la requête de source de l'<iframe> associé avec un en-tête Sec-Browsing-Topics contenant les sujets sélectionnés pour l'utilisateur·ice actuel·le.
Exemples
Lecture
Définir browsingtopics à true puis charger le contenu de l'<iframe> de manière déclarative :
<iframe browsingtopics title="Conteneur publicitaire" src="ad-tech1.example">
...
</iframe>
Afficher la valeur de browsingTopics via un script :
const iframeElem = document.querySelector("iframe");
console.log(iframeElem.browsingTopics); // retournera true dans les navigateurs compatibles
Écriture
Définir un <iframe> minimal :
<iframe> ... </iframe>
Définir browsingtopics à true puis charger le contenu de l'<iframe> via un script :
const iframeElem = document.querySelector("iframe");
iframeElem.browsingTopics = true;
iframeElem.title = "Conteneur publicitaire";
iframeElem.src = "ad-tech1.example";
Spécifications
Cette fonctionnalité ne fait pas partie d'un standard officiel. Elle est présente dans le brouillon de proposition non officiel de l'API Topics (angl.).