BluetoothRemoteGATTCharacteristic

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 BluetoothRemoteGattCharacteristic interface of the Web Bluetooth API represents a GATT Characteristic, which is a basic data element that provides further information about a peripheral's service.

EventTarget BluetoothRemoteGATTCharacteristic

Instance properties

BluetoothRemoteGATTCharacteristic.service Read only Experimental

Returns the BluetoothRemoteGATTService this characteristic belongs to.

BluetoothRemoteGATTCharacteristic.uuid Read only Experimental

Returns a string containing the UUID of the characteristic, for example '00002a37-0000-1000-8000-00805f9b34fb' for the Heart Rate Measurement characteristic.

BluetoothRemoteGATTCharacteristic.properties Read only Experimental

Returns the properties of this characteristic.

BluetoothRemoteGATTCharacteristic.value Read only Experimental

The currently cached characteristic value. This value gets updated when the value of the characteristic is read or updated via a notification or indication.

Instance methods

BluetoothRemoteGATTCharacteristic.getDescriptor() Experimental

Returns a Promise that resolves to the first BluetoothRemoteGATTDescriptor for a given descriptor UUID.

BluetoothRemoteGATTCharacteristic.getDescriptors() Experimental

Returns a Promise that resolves to an Array of all BluetoothRemoteGATTDescriptor objects for a given descriptor UUID.

BluetoothRemoteGATTCharacteristic.readValue() Experimental

Returns a Promise that resolves to an DataView holding a duplicate of the value property if it is available and supported. Otherwise it throws an error.

BluetoothRemoteGATTCharacteristic.writeValue() Deprecated

Sets the value property to the bytes contained in a given ArrayBuffer, writes the characteristic value with optional response, and returns the resulting Promise.

BluetoothRemoteGATTCharacteristic.writeValueWithResponse() Experimental

Sets the value property to the bytes contained in a given ArrayBuffer, writes the characteristic value with required response, and returns the resulting Promise.

BluetoothRemoteGATTCharacteristic.writeValueWithoutResponse() Experimental

Sets the value property to the bytes contained in a given ArrayBuffer, writes the characteristic value without response, and returns the resulting Promise.

BluetoothRemoteGATTCharacteristic.startNotifications() Experimental

Returns a Promise that resolves when navigator.bluetooth is added to the active notification context.

BluetoothRemoteGATTCharacteristic.stopNotifications() Experimental

Returns a Promise that resolves when navigator.bluetooth is removed from the active notification context.

Events

characteristicvaluechanged Experimental

Fired on a BluetoothRemoteGATTCharacteristic when its value changes.

Specifications

Specification
Web Bluetooth
# bluetoothgattcharacteristic-interface

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
BluetoothRemoteGATTCharacteristic
Experimental
characteristicvaluechanged event
Experimental
getDescriptor
Experimental
getDescriptors
Experimental
properties
Experimental
readValue
Experimental
service
Experimental
startNotifications
Experimental
stopNotifications
Experimental
uuid
Experimental
value
Experimental
writeValue
Deprecated
writeValueWithResponse
Experimental
writeValueWithoutResponse
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Deprecated. Not for use in new websites.
See implementation notes.
Has more compatibility info.