BluetoothCharacteristicProperties
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Bluetooth API")}}{{securecontext_header}}{{SeeCompatTable}}
The **BluetoothCharacteristicProperties** interface of the Web Bluetooth API provides the operations that are valid on the given {{domxref('BluetoothRemoteGATTCharacteristic')}}.
This interface is returned by calling {{DOMxRef("BluetoothRemoteGATTCharacteristic.properties")}}.
Instance properties
- {{DOMxRef("BluetoothCharacteristicProperties.authenticatedSignedWrites","authenticatedSignedWrites")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif signed writing to the characteristic value is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.broadcast", "broadcast")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif the broadcast of the characteristic value is permitted using the Server Characteristic Configuration Descriptor. - {{DOMxRef("BluetoothCharacteristicProperties.indicate","indicate")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif indications of the characteristic value with acknowledgement is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.notify","notify")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif notifications of the characteristic value without acknowledgement is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.read", "read")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif the reading of the characteristic value is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.reliableWrite","reliableWrite")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif reliable writes to the characteristic is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.writableAuxiliaries","writableAuxiliaries")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif reliable writes to the characteristic descriptor is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.write","write")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif the writing to the characteristic with response is permitted. - {{DOMxRef("BluetoothCharacteristicProperties.writeWithoutResponse","writeWithoutResponse")}} {{ReadOnlyInline}} {{Experimental_Inline}}
- : Returns a
booleanthat istrueif the writing to the characteristic without response is permitted.
Examples
The following example shows how tell if a GATT characteristic supports value change notifications.
js
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
{{Specifications}}
Browser compatibility
{{Compat}}