HTMLIFrameElement : propriété browsingTopics
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.
Obsolète: Cette fonctionnalité n'est plus recommandée. Même si certains navigateurs la prennent encore en charge, elle a peut-être déjà été supprimée des standards du web, est en passe d'être supprimée ou n'est conservée qu'à des fins de compatibilité. Évitez de l'utiliser et mettez à jour le code existant si possible ; consultez le tableau de compatibilité au bas de cette page pour vous aider à prendre votre décision. Sachez que cette fonctionnalité peut cesser de fonctionner à tout moment.
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.).