Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
This is an experimental technologyCheck 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 BluetoothThe definition of 'getDevices()' in that specification. | Draft | Initial definition. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
No compatibility data found. Please contribute data for "api.Bluetooth.getDevices" (depth: 1) to the MDN compatibility data repository.
Bluetooth.getDevices() by Mozilla Contributors is licensed under CC-BY-SA 2.5.