Permissions-Policy : directive bluetooth
Disponibilité limitée
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.
L'en-tête HTTP Permissions-Policy avec la directive bluetooth contrôle si le document courant est autorisé à utiliser l'API Web Bluetooth.
Plus précisément, lorsqu'une politique définie bloque l'utilisation de cette fonctionnalité, les méthodes de l'objet Bluetooth retourné par Navigator.bluetooth bloqueront l'accès :
Bluetooth.getAvailability()retourne toujours une promesse (Promise) résolue avec une valeur defalse.Bluetooth.getDevices()rejette sa promesse (Promise) retournée avec uneSecurityErrorde l'objetDOMException.Bluetooth.requestDevice()rejette sa promesse (Promise) retournée avec uneSecurityErrorde l'objetDOMException.
Syntaxe
Permissions-Policy: bluetooth=<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 bluetooth est self. Le contexte de navigation de premier niveau et les cadres intégrés de même origine sont autorisés à accéder à la fonctionnalité bluetooth par défaut.
Exemples
Utilisation simple
SecureCorp Inc. souhaite interdire l'utilisation de bluetooth dans toutes les cadres intégrés inter-origines, sauf celles dont l'origine est https://exemple.com. Elle peut le faire en envoyant l'en-tête HTTP suivant pour définir une politique de permissions :
Permissions-Policy: bluetooth=(self "https://exemple.com")
SecureCorp Inc. doit également inclure un attribut allow sur chaque élément <iframe> où bluetooth doit être autorisé :
<iframe src="https://exemple.com/blue" allow="bluetooth"></iframe>
Note :
La spécification de l'en-tête Permissions-Policy de cette manière interdit l'utilisation de bluetooth pour d'autres origines, même si elles sont autorisées par l'attribut allow de l'élément <iframe>.
Utiliser la politique par défaut
Si une liste d'autorisation pour bluetooth n'est pas définie par un en-tête de réponse Permissions-Policy, les agents utilisateurs appliqueront la liste d'autorisation par défaut self. Dans ce mode, bluetooth est automatiquement autorisé dans le contexte de navigation de premier niveau et les cadres intégrés de même origine, mais pas dans les cadres intégrés inter-origines.
Pour autoriser bluetooth dans un cadre intégré inter-origine, incluez un attribut allow sur l'élément <iframe> :
<iframe src="https://autre.com/blue" allow="bluetooth"></iframe>
Spécifications
| Spécification |
|---|
| Web Bluetooth # permissions-policy |
Compatibilité des navigateurs
Voir aussi
- L'en-tête
Permissions-Policy - Politique de permissions