BluetoothDevice (Firefox OS)

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

Interface overview

[CheckPermissions="bluetooth"]
interface BluetoothDevice: EventTarget
{
  readonly attribute DOMString address;
  readonly attribute BluetoothClassOfDevice cod;
  readonly attribute DOMString name;
  readonly attribute boolean paired;
  [Cached, Pure] readonly attribute sequence<DOMString> uuids;
  readonly attribute BluetoothDeviceType type;
  readonly attribute BluetoothGatt? gatt;

           attribute EventHandler onattributechanged;

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

Properties

BluetoothDevice.address Read only

A string representing the address of the device on the Bluetooth micro-network.

BluetoothDevice.cod Read only

Returns a BluetoothClassOfDevice object containing information about the device's capabilities.

BluetoothDevice.gatt Read only

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 Read only

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.services Read only

An Array of strings indicating what kind of Bluetooth services the device is able to provide.

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.)

Obsolete properties

BluetoothDevice.class Read only

A number representing the Bluetooth "Class of Device" number for the device.

BluetoothDevice.connected Read only

A boolean indicating if the device is connected to the adapter (true) or not (false).

BluetoothDevice.icon Read only

A string indicating which kind of icon could be used to represent the device.

Methods

BluetoothDevice.fetchUuids()

Fetches the up-to-date UUID list of services that the device provides. If the operation succeeds, an BluetoothDevice_%28Firefox_OS%29.onattributechanged is triggered right before the Promise is resolved to indicate BluetoothDevice.uuids has changed.

Specifications

Browser Compatibility

See also

Using the Web Bluetooth API