Bluetooth API
The BluetoothCharacteristicProperties interface of the Web Bluetooth API provides the operations that are valid on the given BluetoothRemoteGATTCharacteristic.
This interface is returned by calling BluetoothRemoteGATTCharacteristic.properties.
Instance properties
- BluetoothCharacteristicProperties.authenticatedSignedWrites
- : Returns a
booleanthat istrueif signed writing to the characteristic value is permitted.
- : Returns a
- BluetoothCharacteristicProperties.broadcast
- : Returns a
booleanthat istrueif the broadcast of the characteristic value is permitted using the Server Characteristic Configuration Descriptor.
- : Returns a
- BluetoothCharacteristicProperties.indicate
- : Returns a
booleanthat istrueif indications of the characteristic value with acknowledgement is permitted.
- : Returns a
- BluetoothCharacteristicProperties.notify
- : Returns a
booleanthat istrueif notifications of the characteristic value without acknowledgement is permitted.
- : Returns a
- BluetoothCharacteristicProperties.read
- : Returns a
booleanthat istrueif the reading of the characteristic value is permitted.
- : Returns a
- BluetoothCharacteristicProperties.reliableWrite
- : Returns a
booleanthat istrueif reliable writes to the characteristic is permitted.
- : Returns a
- BluetoothCharacteristicProperties.writableAuxiliaries
- : Returns a
booleanthat istrueif reliable writes to the characteristic descriptor is permitted.
- : Returns a
- BluetoothCharacteristicProperties.write
- : Returns a
booleanthat istrueif the writing to the characteristic with response is permitted.
- : Returns a
- BluetoothCharacteristicProperties.writeWithoutResponse
- : Returns a
booleanthat istrueif the writing to the characteristic without response is permitted.
- : Returns a
Examples
The following example shows how tell if a GATT characteristic supports value change notifications.
let device = await navigator.bluetooth.requestDevice({
filters: [{ services: ["heart_rate"] }],
});
let gatt = await device.gatt.connect();
let service = await gatt.getPrimaryService("heart_rate");
let characteristic = await service.getCharacteristic("heart_rate_measurement");
if (characteristic.properties.notify) {
characteristic.addEventListener(
"characteristicvaluechanged",
async (event) => {
console.log(`Received heart rate measurement: ${event.target.value}`);
},
);
await characteristic.startNotifications();
}
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
