Bluetooth: getAvailability() Methode

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.

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 Benutzeragent Bluetooth unterstützen kann (weil das Gerät einen Bluetooth-Adapter hat), und false andernfalls.

Das Wort "nominal" wird verwendet, weil, wenn die Berechtigung zur Verwendung der Web Bluetooth API durch die Berechtigung Permissions-Policy: bluetooth 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 funktionsfähigen Bluetooth-Adapter hat, und umgekehrt. Dieser Einstellungswert wird ignoriert, wenn der Zugriff durch die Berechtigung blockiert wird.

Auch wenn getAvailability() true zurückgibt und das Gerät tatsächlich einen Bluetooth-Adapter hat, bedeutet dies nicht unbedingt, dass ein Aufruf von navigator.bluetooth.requestDevice() mit einem BluetoothDevice aufgelöst wird. Der Bluetooth-Adapter ist möglicherweise nicht eingeschaltet, und ein Benutzer könnte die Erlaubnis zur Verwendung der API verweigern, wenn er dazu aufgefordert wird.

Syntax

js
getAvailability()

Parameter

Keine.

Rückgabewert

Ein Promise, das 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 Code-Schnipsel gibt eine Meldung in der Konsole aus, die angibt, ob Bluetooth vom Gerät unterstützt wird oder nicht:

js
navigator.bluetooth.getAvailability().then((available) => {
  if (available) {
    console.log("This device supports Bluetooth!");
  } else {
    console.log("Doh! Bluetooth is not supported");
  }
});

Spezifikationen

Specification
Web Bluetooth
# dom-bluetooth-getavailability

Browser-Kompatibilität