Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The getDevices()
method of Bluetooth
interface of Web Bluetooth API exposes the Bluetooth devices this origin is allowed to access. This method does not display any permission prompts.
Note: This method returns a BluetoothDevice
for each device the origin is currently allowed to access, even the ones that are out of range or powered off. The program can detect when a device comes online or into range by watching for BlueTooth advertisements by calling BluetoothDevice.watchAdvertisements()
on that device.
Syntax
var readerPromise = Bluetooth.getDevices();
Parameters
None.
Return value
A Promise
that resolves with an array of BluetoothDevice
s.
Exceptions
This method doesn't throw any exceptions.
Specifications
Specification | Status | Comment |
---|---|---|
Web Bluetooth The definition of 'getDevices()' in that specification. |
Draft | Initial definition. |
Browser compatibility
No compatibility data found. Please contribute data for "api.Bluetooth.getDevices" (depth: 1) to the MDN compatibility data repository.