This is an experimental technologyCheck 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.
This page describes the W3C Community Group Web Bluetooth API. For the Firefox OS Bluetooth API, see [[../../../Archive/B2G_OS/API/BluetoothGattDescriptor|BluetoothGattDescriptor
(Firefox OS)]].
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 BluetoothThe 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Chrome Full support 57 Full support 57 Notes' macOS only. Full support 57 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 57: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 44 Full support 44 Notes' macOS only. Full support 44 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 44: this feature is behind the Notes' Windows 10. |
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 |
Chrome Full support 57 Full support 57 Notes' macOS only. Full support 57 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 57: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 44 Full support 44 Notes' macOS only. Full support 44 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 44: this feature is behind the Notes' Windows 10. |
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 | |
Chrome Full support 57 Full support 57 Notes' macOS only. Full support 57 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 57: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 44 Full support 44 Notes' macOS only. Full support 44 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 44: this feature is behind the Notes' Windows 10. |
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 | |
Chrome Full support 57 Full support 57 Notes' macOS only. Full support 57 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 57: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 44 Full support 44 Notes' macOS only. Full support 44 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 44: this feature is behind the Notes' Windows 10. |
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 | |
Chrome Full support 57 Full support 57 Notes' macOS only. Full support 57 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 57: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 44 Full support 44 Notes' macOS only. Full support 44 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 44: this feature is behind the Notes' Windows 10. |
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 | |
Chrome Full support 57 Full support 57 Notes' macOS only. Full support 57 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 57: this feature is behind the Notes' Windows 10. |
Edge Full support ≤79 Full support ≤79 Notes' macOS only. Full support ≤79 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version ≤79: this feature is behind the Notes' Windows 10. |
Firefox
No support No |
IE
No support No |
Opera Full support 44 Full support 44 Notes' macOS only. Full support 44 Notes' Linux and versions of Windows earlier than 10.
Disabled' From version 44: this feature is behind the Notes' Windows 10. |
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.
BluetoothRemoteGATTDescriptor by Mozilla Contributors is licensed under CC-BY-SA 2.5.