• Skip to main content
  • Select language
  • Skip to search
MDN Web Docs
  • Technologies
    • HTML
    • CSS
    • JavaScript
    • Graphics
    • HTTP
    • APIs / DOM
    • WebExtensions
    • MathML
  • References & Guides
    • Learn web development
    • Tutorials
    • References
    • Developer Guides
    • Accessibility
    • Game development
    • ...more docs
B2G OS
  1. MDN
  2. Archive of obsolete content
  3. B2G OS
  4. B2G OS APIs
  5. BluetoothGattCharacteristic (Firefox OS)

BluetoothGattCharacteristic (Firefox OS)

In This Article
  1. Interface overview
  2. Properties
  3. Methods
  4. Specifications
  5. Browser Compatibility
  6. See also

This API is available on Firefox OS for internal applications only.

The BluetoothGattCharacteristic interface of the Web Bluetooth API represents a GATT service characteristic, which includes characteristic definition, value, properties and configuration info, and a list of descriptors that provide related information.

Interface overview

[CheckPermissions="bluetooth"]
interface BluetoothGattCharacteristic
{ 
  readonly attribute BluetoothGattService service;
  [Cached, Pure] readonly attribute sequence<BluetoothGattDescriptor> descriptors;
  readonly attribute DOMString uuid;
  readonly attribute unsigned short instanceId;
  readonly attribute ArrayBuffer? value;
  [Cached, Constant] readonly attribute Permissions permissions;
  [Cached, Constant] readonly attribute GattCharacteristicProperties properties;
  [Cached, Pure]              attribute WriteType writeType;
  [NewObject] Promise<ArrayBuffer> readValue();
  [NewObject] Promise<void> writeValue(ArrayBuffer value);
  [NewObject] Promise<void> startNotifications();
  [NewObject] Promise<void> stopNotifications();
  [NewObject] Promise<BluetoothGattDescriptor> addDescriptor(DOMString uuid, Permissions permissions, ArrayBuffer value);
};

Properties

BluetoothGattCharacteristic.service Read only
Returns the BluetoothGattService that this characteristic belongs to.
BluetoothGattCharacteristic.descriptors Read only
Returns a cached array containing the BluetoothGattDescriptor objects that describe this characteristic.
BluetoothGattCharacteristic.uuid Read only
Returns a DOMString representing the UUID of this characteristic.
BluetoothGattCharacteristic.instanceId Read only
Returns a number representing the instance id of this characteristic.
BluetoothGattCharacteristic.value Read only
Returns The cached value of this characteristic. This value can be updated via the BluetoothGattCharacteristic.readValue() method, characteristic notification, or indication from the remote device.
BluetoothGattCharacteristic.permissions Read only
Returns a bit mask that describes the operations permitted on this characteristic.
BluetoothGattCharacteristic.properties Read only
Returns a bit mask that describes how to use the characteristic value.
BluetoothGattCharacteristic.writeType Read only
Returns the type of write operation particular to this characteristic.

Methods

BluetoothGattCharacteristic.readValue()
Reads the characteristic value from the remote device. The cached value property will also be updated after retrieving the value.
BluetoothGattCharacteristic.writeValue()
Writes the characteristic value to the GATT server. If the local device is the GATT client, the value will be written to the remote GATT server. On the other hand, if the local device is the GATT server, the value will be written to BluetoothGattCharacteristic.value.
BluetoothGattCharacteristic.startNotifications()
Registers notifications/indications for this characteristic.
BluetoothGattCharacteristic.stopNotifications()
Unregisters notifications/indications for this characteristic.
BluetoothGattCharacteristic.addDescriptor()
Adds a descriptor to this characteristic.

Specifications

Specification Status Comment
Web Bluetooth
The definition of 'BluetoothGattCharacteristic' in that specification.
Draft Rough draft; not part of any official specification yet. It should be discussed as part of the W3C's System Applications Working Group.

Browser Compatibility

  • Desktop
  • Mobile
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support No support No support No support No support
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support No support No support 2.1 No support No support No support No support

 

See also

Using the Web Bluetooth API

Document Tags and Contributors

Tags: 
  • API
  • B2G
  • Bluetooth
  • BluetoothGattCharacteristic
  • Certified
  • Firefox OS
  • Interface
  • Non-standard
  • Reference
  • Web Bluetooth
 Contributors to this page: chrisdavidmills
 Last updated by: chrisdavidmills, Feb 27, 2017, 2:38:28 AM
See also
  1. Web Bluetooth API
  2. Archive
  3. Related pages for Bluetooth API (Firefox OS)
    1. BluetoothAdapter
    2. BluetoothAdapterEvent
    3. BluetoothAttributeEvent
    4. BluetoothClassOfDevice
    5. BluetoothDevice
    6. BluetoothDeviceEvent
    7. BluetoothDiscoveryHandle
    8. BluetoothGatt
    9. BluetoothGattCharacteristic
    10. BluetoothGattCharacteristicEvent
    11. BluetoothGattDescriptor
    12. BluetoothGattServer
    13. BluetoothGattService
    14. BluetoothLeDeviceEvent
    15. BluetoothManager
    16. BluetoothPairingEvent
    17. BluetoothPairingHandle
    18. BluetoothPairingListener