BluetoothRemoteGATTDescriptor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

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

Instance properties

BluetoothRemoteGATTDescriptor.characteristic Read only Experimental

Returns the BluetoothRemoteGATTCharacteristic this descriptor belongs to.

BluetoothRemoteGATTDescriptor.uuid Read only Experimental

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

BluetoothRemoteGATTDescriptor.value Read only Experimental

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

Instance methods

BluetoothRemoteGATTDescriptor.readValue() Experimental

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() Experimental

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

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android
BluetoothRemoteGATTDescriptor
70Linux support is not enabled by default.
57–70Only supported on macOS.
79Linux support is not enabled by default.
No
57Linux support is not enabled by default.
44–57Only supported on macOS.
No 57 No 44 No 7.0 No
characteristic 57 79 No 44 No 57 No 44 No 7.0 No
readValue 57 79 No 44 No 57 No 44 No 7.0 No
uuid 57 79 No 44 No 57 No 44 No 7.0 No
value 57 79 No 44 No 57 No 44 No 7.0 No
writeValue 57 79 No 44 No 57 No 44 No 7.0 No

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