使用 try...catch 语句包裹 web bluetooth api 的调用,可以捕获同步抛出的错误以及部分异步操作失败时产生的异常。对于返回 promise 的方法(如 navigator.bluetooth.requestdevice()),必须在其后挂载 .catch() 方法或使用 async/await 结构中的 try...catch 块来接收拒绝(rejection)的错误对象。web bluetooth 的错误通常表现为 domexception,其中包含 name 属性用于区分错误类型,例如 notfounderror 表示未找到设备,securityerror 表示权限被拒。

如何区分不同的蓝牙连接错误类型
通过检查错误对象的 name 属性可以精确识别错误原因。常见的错误包括用户取消选择、设备不可用或权限不足。在代码中,应针对这些特定的 name 值编写分支逻辑,以便向用户提供友好的提示或执行降级策略。

const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }],
optionalServices: ['device_information']
});
try {
const server = await device.gatt.connect();
console.log('Connected to', device.name);
} catch (error) {
if (error.name === 'SecurityError') {
console.error('Connection rejected by user or security policy');
} else if (error.name === 'NetworkError') {
console.error('Failed to connect to the device');
} else {
console.error('Unknown error:', error.message);
}
}
如何处理可选服务连接失败的情况
当请求连接的设备支持多个 GATT 服务时,获取特定服务的特性可能会失败。如果某个服务不是必需的,应在访问其特性前检查服务是否存在,或者在 getPrimaryService() 的 catch 块中处理缺失服务的异常,避免整个流程中断。
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。

try {
const service = await server.getPrimaryService('battery_service');
const characteristic = await service.getCharacteristic('battery_level');
const value = await characteristic.readValue();
console.log('Battery level:', value.getUint8(0));
} catch (error) {
if (error.name === 'NotFoundError') {
console.warn('Battery service not available on this device');
} else {
console.error('Error accessing service:', error.message);
}
}
基于设备断开连接事件的具体问题
Web Bluetooth 连接可能在任何时候因信号丢失或用户操作而断开。为了保持应用的健壮性,必须监听 gattserverdisconnected 事件。该事件会在连接意外终止时触发,允许应用重新尝试连接或更新 UI 状态,而不是让程序处于未知的挂起状态。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










