在此页

• 特性
• 范例
• 规范
• 浏览器兼容性
• 相关话题

草案
此页面不完整。

安全上下文
此特征只可用于 安全上下文 (HTTPS)，在某些或所有 支持浏览器 .

这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

BluetoothCharacteristicProperties 接口的 Web Bluetooth API provides the operations that are valid on the given BluetoothRemoteGATTCharacteristic . This interface is returned by calling BluetoothRemoteGATTCharacteristic.properties .

特性

authenticatedSignedWrites 只读

返回 boolean 也就是 true if signed writing to the characteristic value is permitted.

broadcast 只读

返回 boolean 也就是 true if the broadcast of the characteristic value is permitted using the Server Characteristic Configuration Descriptor.

indicate 只读

返回 boolean 也就是 true if indications of the characteristic value with acknowledgement is permitted.

notify 只读

返回 boolean 也就是 true if notifications of the characteristic value without acknowledgement is permitted.

read 只读

返回 boolean 也就是 true if the reading of the characteristic value is permitted.

reliableWrite 只读

返回 boolean 也就是 true if reliable writes to the characteristic is permitted.

writableAuxiliaries 只读

返回 boolean 也就是 true if reliable writes to the characteristic descriptor is permitted.

write 只读

返回 boolean 也就是 true if the writing to the characteristic with response is permitted.

writeWithoutResponse 只读

返回 boolean 也就是 true if the writing to the characteristic without response is permitted.

范例

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) {
  characteristics.addEventListener('characteristicvaluechanged',
      function(event) {
    console.log(`Received heart rate measurement: ${event.target.value}`);
  }
  await characteristic.startNotifications();
}
					

规范

规范	状态	注释
Web Bluetooth The definition of 'BluetoothCharacteristicProperties' in that specification.	草案	初始定义。

浏览器兼容性

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. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
BluetoothCharacteristicProperties	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
authenticatedSignedWrites	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
broadcast	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
indicate	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
notify	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
read	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
reliableWrite	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
writableAuxiliaries	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
write	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0
writeWithoutResponse	Chrome 56 注意事项 56 注意事项 ChromeOS and macOS only. 56 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version 56: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). To change preferences in Chrome, visit chrome://flags. 70 注意事项 Windows 10.	Edge ≤79 注意事项 ≤79 注意事项 EdgeOS and macOS only. ≤79 注意事项 Disabled Linux and versions of Windows earlier than 10. Disabled From version ≤79: this feature is behind the #enable-experimental-web-platform-features preference (needs to be set to enabled ). ≤79 注意事项 Windows 10.	Firefox 不支持 No	IE 不支持 No	Opera Yes	Safari 不支持 No	WebView Android 不支持 No	Chrome Android 56	Firefox Android 不支持 No	Opera Android Yes	Safari iOS 不支持 No	Samsung Internet Android 6.0

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

见实现注意事项。

用户必须明确启用此特征。

用户必须明确启用此特征。

元数据

• 最后修改： May 27, 2020

相关话题

1. Web Bluetooth API
2. BluetoothCharacteristicProperties
3. 特性

   1. authenticatedSignedWrites
   2. broadcast
   3. indicate
   4. notify
   5. read
   6. reliableWrite
   7. writableAuxiliaries
   8. write
   9. writeWithoutResponse
4. Related pages for Bluetooth API

   1. BluetoothAdvertisingData
   2. BluetoothDevice
   3. BluetoothGATTCharacteristic
   4. BluetoothGATTDescriptor
   5. BluetoothGATTRemoteServer
   6. BluetoothGATTService