BluetoothRemoteGATTDescriptor

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The BluetoothRemoteGATTDescriptor interface of the Web Bluetooth API provides a GATT Descriptor, which provides further information about a characteristic’s value.

Note: This page describes the W3C Community Group Web Bluetooth API. For the Firefox OS Bluetooth API, see BluetoothGattDescriptor (Firefox OS).

Properties

BluetoothRemoteGATTDescriptor.characteristicRead only

Returns the BluetoothRemoteGATTCharacteristic this descriptor belongs to.

BluetoothRemoteGATTDescriptor.uuidRead only

Returns the UUID of the characteristic descriptor, for example '00002902-0000-1000-8000-00805f9b34fb' for theClient Characteristic Configuration descriptor.

BluetoothRemoteGATTDescriptor.valueRead only

Returns the currently cached descriptor value. This value gets updated when the value of the descriptor is read.

Methods

BluetoothRemoteGATTDescriptor.readValue()

Returns a Promise that resolves to an ArrayBuffer holding a duplicate of the value property if it is available and supported. Otherwise it throws an error.

BluetoothRemoteGATTDescriptor.writeValue()

Sets the value property to the bytes contained in an ArrayBuffer and returns a Promise.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
BluetoothRemoteGATTDescriptor
57
Before Chrome 70, this feature was only supported in macOS. In Chrome 70, support was added for Windows 10. Linux support is not enabled by default.
57
In Linux and versions of Windows earlier than 10, this flag must be enabled.
79
Supported by default only on macOS and Windows 10. Linux support is not enabled by default.
79
In Linux and versions of Windows earlier than 10, this flag must be enabled.
No
No
44
Before Opera 57, this feature was only supported in macOS. In Opera 57, support was added for Windows 10. Linux support is not enabled by default.
44
In Linux and versions of Windows earlier than 10, this flag must be enabled.
No
No
57
No
44
No
7.0
characteristic
57
79
No
No
44
No
No
57
No
44
No
7.0
readValue
57
79
No
No
44
No
No
57
No
44
No
7.0
uuid
57
79
No
No
44
No
No
57
No
44
No
7.0
value
57
79
No
No
44
No
No
57
No
44
No
7.0
writeValue
57
79
No
No
44
No
No
57
No
44
No
7.0

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/BluetoothRemoteGATTDescriptor