Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Permissions-Policy : directive browsing-topics

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.

L'en-tête HTTP Permissions-Policy avec la directive browsing-topics contrôle l'accès à l'API Topics.

Lorsqu'une politique interdit spécifiquement l'utilisation de l'API Topics, toute tentative d'appel de la méthode Document.browsingTopics() ou d'envoi d'une requête avec un en-tête Sec-Browsing-Topics échouera avec une NotAllowedError de l'objet DOMException.

Syntaxe

http
Permissions-Policy: browsing-topics=<allowlist>;
<allowlist>

Une liste d'origines pour lesquelles la permission est accordée pour utiliser la fonctionnalité. Voir Permissions-Policy > Syntaxe pour plus de détails.

Règle par défaut

La liste d'autorisation par défaut pour browsing-topics est *.

Spécifications

Cette fonctionnalité ne fait partie d'aucun standard officiel, bien qu'elle soit définie dans le brouillon de proposition non officiel de l'API Topics (angl.).

Compatibilité des navigateurs

Voir aussi