BluetoothDevice

Description

The BluetoothDevice interface of the Bluetooth API provides information regarding a given Bluetooth device.

Interface overview

[CheckAnyPermissions="bluetooth"]

interface BluetoothDevice: EventTarget

{

readonly attribute DOMString address;

readonly attribute BluetoothClassOfDevice cod;

readonly attribute DOMString name;

readonly attribute boolean paired;

readonly attribute BluetoothDeviceType type;

[Cached, Pure] readonly attribute sequence<DOMString> uuids;

readonly attribute BluetoothGatt? gatt;

attribute EventHandler onattributechanged;

[NewObject] Promise<sequence<DOMString>> fetchUuids();

};

Properties

• BluetoothDevice.address A string representing the address of the device on the Bluetooth micro-network.
• BluetoothDevice.cod Returns a BluetoothClassOfDevice object containing information about the device's capabilities.
• BluetoothDevice.gatt Returns a BluetoothGatt object that allows JavaScript to conduct GATT client operations on a remote LE device. This property will return null for devices of type classic or unknown.
• BluetoothDevice.name The human readable name of the device.
• BluetoothDevice.paired {.read-only} A boolean indicating if the device is paired to the adapter (true) or not (false).
• BluetoothDevice.type {.read-only} Returns the device type of the remote device.
• BluetoothDevice.uuids {.read-only} An Array of strings indicating the UUIDs of each Bluetooth service the device is able to provide.

Event handlers

• BluetoothDevice.onattributechanged Defines a handler for the attributechanged event; triggers when a remote device's properties have changed (has a BluetoothAttributeEvent as a parameter.)

Methods

• BluetoothDevice.fetchUuids Fetches the up-to-date UUID list of services that the device provides. If the fetchUuids operation succeeds, an onattributechanged would be triggered right before the Promise is resolved to indicate device.uuids has changed.