ContextQMD
Back to Content

BluetoothUUID

files/en-us/web/api/bluetoothuuid/index.md

latest1.9 KB
Original Source

{{APIRef("Bluetooth API")}}

The BluetoothUUID interface of the Web Bluetooth API provides a way to look up Universally Unique Identifier (UUID) values by name in the registry maintained by the Bluetooth SIG.

Description

A UUID string is a 128-bit UUID, for example 00001818-0000-1000-8000-00805f9b34fb. The Bluetooth registry contains lists of descriptors, services, and characteristics identified by these UUIDs in addition to a 16- or 32- bit alias, and a name.

The BluetoothUUID interface provides methods to retrieve these 128-bit UUIDs.

Static methods

  • BluetoothUUID.canonicalUUID() {{Experimental_Inline}}
    • : Returns the 128-bit UUID when passed the 16- or 32-bit UUID alias.
  • BluetoothUUID.getCharacteristic() {{Experimental_Inline}}
    • : Returns the 128-bit UUID representing a registered characteristic when passed a name or the 16- or 32-bit UUID alias.
  • BluetoothUUID.getDescriptor() {{Experimental_Inline}}
    • : Returns a UUID representing a registered descriptor when passed a name or the 16- or 32-bit UUID alias.
  • BluetoothUUID.getService() {{Experimental_Inline}}
    • : Returns a UUID representing a registered service when passed a name or the 16- or 32-bit UUID alias.

Examples

In the following example the UUID representing the service named device_information is returned and printed to the console.

js
let result = BluetoothUUID.getService("device_information");
console.log(result); // "0000180a-0000-1000-8000-00805f9b34fb"

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}