Bluetooth: getDevices()-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, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Die getDevices()-Methode der Bluetooth-Schnittstelle gibt ein Array zurück, das die Bluetooth-Geräte enthält, auf die dieser Ursprung zugreifen darf — einschließlich derer, die sich außerhalb der Reichweite befinden und ausgeschaltet sind.

Syntax

js
getDevices()

Parameter

Keine.

Rückgabewert

Ein Promise, der mit einem Array von BluetoothDevice-Objekten aufgelöst wird.

Ausnahmen

SecurityError DOMException

Wird ausgelöst, wenn diese Operation in diesem Kontext aufgrund von Sicherheitsbedenken nicht erlaubt ist, wie zum Beispiel, wenn der Zugriff auf das aktuelle Dokument durch die Permissions Policy-Richtlinie bluetooth blockiert wird.

Spezifikationen

Specification
Web Bluetooth
# dom-bluetooth-getdevices

Browser-Kompatibilität

BCD tables only load in the browser