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.characteristicRead only- Returns the
BluetoothRemoteGATTCharacteristicthis 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
Promisethat resolves to anArrayBufferholding a duplicate of thevalueproperty if it is available and supported. Otherwise it throws an error. BluetoothRemoteGATTDescriptor.writeValue()- Sets the value property to the bytes contained in an
ArrayBufferand 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.
