Bluetooth: getAvailability() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die getAvailability() Methode der Bluetooth Schnittstelle gibt nominal true zurück, wenn der User-Agent Bluetooth unterstützen kann (weil das Gerät einen Bluetooth-Adapter hat) und false andernfalls.
Das Wort "nominal" wird verwendet, weil wenn die Erlaubnis zur Verwendung der Web Bluetooth API durch die Permissions-Policy: bluetooth Berechtigung verweigert wird, die Methode immer false zurückgibt.
Darüber hinaus kann ein Benutzer seinen Browser so konfigurieren, dass er false von einem getAvailability() Aufruf zurückgibt, selbst wenn der Browser einen funktionierenden Bluetooth-Adapter hat, und umgekehrt. Dieser Einstellungswert wird ignoriert, wenn der Zugriff durch die Berechtigung blockiert ist.
Selbst wenn getAvailability() true zurückgibt und das Gerät tatsächlich einen Bluetooth-Adapter hat, bedeutet dies nicht unbedingt, dass der Aufruf von navigator.bluetooth.requestDevice() mit einem BluetoothDevice aufgelöst wird.
Der Bluetooth-Adapter könnte nicht eingeschaltet sein, und ein Benutzer könnte die Erlaubnis zur Nutzung der API verweigern, wenn er dazu aufgefordert wird.
Syntax
getAvailability()
Parameter
Keine.
Rückgabewert
Ein Promise, der mit einem Boolean aufgelöst wird.
Das Promise wird mit einem Wert von false aufgelöst, wenn der Zugriff durch Permissions-Policy: bluetooth verweigert wird, wenn der Benutzer den Browser so konfiguriert hat, dass er immer mit false aufgelöst wird, oder wenn das Gerät keinen Bluetooth-Adapter hat.
Andernfalls wird es mit true aufgelöst.
Ausnahmen
Keine.
Beispiele
Der folgende Codeausschnitt gibt im Konsolenfenster eine Nachricht aus, die angibt, ob Bluetooth vom Gerät unterstützt wird oder nicht:
navigator.bluetooth.getAvailability().then((available) => {
if (available) {
console.log("This device supports Bluetooth!");
} else {
console.log("Doh! Bluetooth is not supported");
}
});
Spezifikationen
| Spezifikation |
|---|
| Web Bluetooth # dom-bluetooth-getavailability |