JavaScript 中怎么使用 Promise 处理蓝牙设备搜索与连接的异步流程

千浩同学_3680

千浩同学_3680

2026-09-03

213人浏览

原创

javascript中promise处理蓝牙需封装web bluetooth api为promise链:requestdevice和connect本身返回promise,可直接await;组合搜索、连接、读取需按序await,确保gatt操作在连接后执行,并注意浏览器兼容性与安全上下文要求。

javascript 中怎么使用 promise 处理蓝牙设备搜索与连接的异步流程

JavaScript 中使用 Promise 处理蓝牙设备搜索与连接,核心是将 Web Bluetooth API 的基于事件和回调的操作(如 requestDevice、connect)封装为 Promise 风格,让异步流程更清晰、可链式调用、易错误处理。

封装 requestDevice 为 Promise

原生 navigator.bluetooth.requestDevice() 返回 Promise,但它的 resolve 值是 BluetoothDevice,而实际搜索过程(如过滤、用户选择)由浏览器 UI 控制。你只需处理成功或失败即可,无需额外封装——但它本身已是 Promise:

  • 直接 await 调用,配合 filters 或 optionalServices 提高匹配精度
  • 捕获 NotFoundError(用户未选设备)、SecurityError(未在安全上下文或未用户手势触发)等常见拒绝原因

示例:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

async function selectBluetoothDevice() {
  try {
    const device = await navigator.bluetooth.requestDevice({
      filters: [{ services: ['battery_service'] }], // 按服务名过滤
      optionalServices: ['device_information']
    });
    return device;
  } catch (err) {
    console.error('设备选择失败:', err.name, err.message);
    throw err;
  }
}

将 device.gatt.connect() 封装为 Promise

device.gatt.connect() 本身返回 Promise,但部分浏览器旧版本可能不支持,且连接失败时的错误类型较分散(如 NetworkError、SecurityError)。建议显式包装并统一错误逻辑:

  • 检查 device.gatt 是否存在(避免空引用)
  • await device.gatt.connect(),它会在连接建立后 resolve,失败时 reject
  • 连接成功后,device.gatt.server 即为可用的 BluetoothRemoteGATTServer

示例:

async function connectToDevice(device) {
  if (!device.gatt) {
    throw new Error('设备不支持 GATT');
  }
  try {
    const server = await device.gatt.connect();
    return server;
  } catch (err) {
    console.error('GATT 连接失败:', err.name, err.message);
    throw err;
  }
}

组合搜索 + 连接 + 读取服务的完整 Promise 流程

把设备发现、连接、获取服务、读取特征值串成 Promise 链或 async/await 序列,避免嵌套回调,便于错误冒泡和统一处理:

  • 每个步骤都用 await,任一环节 reject 都会进入 catch
  • 读取电池电量示例:先 getPrimaryService,再 getCharacteristic,最后 readValue()
  • 注意:所有 GATT 操作必须在连接成功后执行,且需处理特征值编码(如 value.getUint8(0))

示例:

async function scanAndReadBattery() {
  try {
    const device = await selectBluetoothDevice();
    const server = await connectToDevice(device);
    const service = await server.getPrimaryService('battery_service');
    const characteristic = await service.getCharacteristic('battery_level');
    const value = await characteristic.readValue();
    const level = value.getUint8(0);
    console.log('电池电量:', level, '%');
    return level;
  } catch (err) {
    console.error('蓝牙全流程失败:', err);
  }
}

注意事项与兼容性提醒

Web Bluetooth 在 Chrome / Edge(桌面)支持良好,但 Safari 和 Firefox 不支持;移动端仅 Chrome for Android 支持。使用前务必检查环境:

  • 确认 'bluetooth' in navigator 为 true
  • 确保页面运行在 HTTPS 或 localhost(安全上下文)
  • 所有蓝牙调用必须由用户手势(如 click)触发,不能在页面加载时自动执行
  • 连接后记得在适当时候调用 device.gatt.disconnect() 释放资源(可封装为 Promise)

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

4206

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1069

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

4084

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

840

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1736

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3065

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

3993

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

2540

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

828

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习