Permissions-Policy: bluetooth-Direktive
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Das HTTP-Header Permissions-Policy bluetooth steuert, ob das aktuelle Dokument die Web Bluetooth API verwenden darf.
Insbesondere, wenn eine definierte Richtlinie die Nutzung dieser Funktion verbietet, verweigern die Methoden des Bluetooth-Objekts, das durch Navigator.bluetooth zurückgegeben wird, den Zugriff:
Bluetooth.getAvailability()wird immer sein zurückgegebenesPromisemit einem Wert vonfalseerfüllen.Bluetooth.getDevices()wird sein zurückgegebenesPromisemit einemSecurityErrorDOMExceptionablehnen.Bluetooth.requestDevice()wird sein zurückgegebenesPromisemit einemSecurityErrorDOMExceptionablehnen.
Syntax
Permissions-Policy: bluetooth=<allowlist>;
<allowlist>-
Eine Liste von Ursprüngen, für die die Erlaubnis erteilt wird, die Funktion zu nutzen. Weitere Details finden Sie unter
Permissions-Policy> Syntax.
Standardrichtlinie
Die Standard-Whitelist für bluetooth ist self.
Beispiele
Allgemeines Beispiel
SecureCorp Inc. möchte die Web Bluetooth API in allen Browsing-Kontexten deaktivieren, außer für deren eigenen Ursprung und solche mit dem Ursprung https://example.com. Dies kann durch die Zustellung des folgenden HTTP-Antwort-Headers zur Definition einer Berechtigungsrichtlinie erreicht werden:
Permissions-Policy: bluetooth=(self "https://example.com")
Mit einem <iframe>-Element
FastCorp Inc. möchte bluetooth für alle Cross-Origin-Kindrahmen deaktivieren, außer für ein bestimmtes <iframe>. Dies kann durch die Zustellung des folgenden HTTP-Antwort-Headers zur Definition einer Berechtigungsrichtlinie erreicht werden:
Permissions-Policy: bluetooth=(self https://other.com/blue)
Fügen Sie dann ein allow-Attribut zum <iframe>-Element hinzu:
<iframe src="https://other.com/blue" allow="bluetooth"></iframe>
<iframe>-Attribute können Funktionen selektiv in bestimmten Frames aktivieren und in anderen nicht, selbst wenn diese Frames Dokumente vom selben Ursprung enthalten.
Spezifikationen
| Specification |
|---|
| Web Bluetooth # permissions-policy |