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.
Interface
interface BluetoothRemoteGATTDescriptor { readonly attribute BluetoothGATTCharacteristic characteristic; readonly attribute UUID uuid; readonly attribute ArrayBuffer? value; Promise<ArrayBuffer> readValue(); Promise<void> writeValue(BufferSource value); };
Properties
BluetoothRemoteGATTDescriptor.characteristic
Read only- Returns the
BluetoothRemoteGATTCharacteristic
this descriptor belongs to. BluetoothRemoteGATTDescriptor.uuid
Read only- Returns the UUID of the characteristic descriptor, for example '
00002902-0000-1000-8000-00805f9b34fb
' for theClient Characteristic Configuration descriptor. BluetoothRemoteGATTDescriptor.value
Read 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 anArrayBuffer
holding a duplicate of thevalue
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 aPromise
.
Specifications
Specification | Status | Comment |
---|---|---|
Web Bluetooth The definition of 'BluetoothRemoteGATTDescriptor' in that specification. |
Draft | Initial definition. |
Browser Compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
BluetoothRemoteGATTDescriptor | Chrome
Full support
57
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera
Full support
44
| Safari No support No | WebView Android No support No | Chrome Android Full support 57 | Firefox Android No support No | Opera Android Full support 44 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
characteristic | Chrome
Full support
57
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera
Full support
44
| Safari No support No | WebView Android No support No | Chrome Android Full support 57 | Firefox Android No support No | Opera Android Full support 44 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
readValue | Chrome
Full support
57
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera
Full support
44
| Safari No support No | WebView Android No support No | Chrome Android Full support 57 | Firefox Android No support No | Opera Android Full support 44 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
uuid | Chrome
Full support
57
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera
Full support
44
| Safari No support No | WebView Android No support No | Chrome Android Full support 57 | Firefox Android No support No | Opera Android Full support 44 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
value | Chrome
Full support
57
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera
Full support
44
| Safari No support No | WebView Android No support No | Chrome Android Full support 57 | Firefox Android No support No | Opera Android Full support 44 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
writeValue | Chrome
Full support
57
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera
Full support
44
| Safari No support No | WebView Android No support No | Chrome Android Full support 57 | Firefox Android No support No | Opera Android Full support 44 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.