Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The BluetoothRemoteGATTDescriptor interface of the Web Bluetooth API provides a GATT Descriptor, which provides further information about a characteristic’s value.
In earlier versions of the spec, this was called BluetoothGATTDescriptor.
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
We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|
| Basic support | 57 | ? | ? | 44 | ? |
| Feature | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | No support | 57 | ? | ? | ? | 44 | ? |