Promise不直接扫描蓝牙设备，而是封装Bluetooth API的异步操作；requestDevice()返回Promise用于用户选择设备，watchAdvertisements()需用Promise+AbortController封装超时监听，批量扫描需结合Promise.all、去重和错误处理。
Promise 本身不直接处理蓝牙设备扫描结果，它只是封装异步操作的工具；真正发起扫描的是 Bluetooth API（如 navigator.bluetooth.requestDevice() 或 watchAdvertisements()），这些 API 返回 Promise 或基于事件的流，你需要用 Promise 配合事件监听、超时控制和结果聚合来合理管理扫描过程。
用 Promise 封装 requestDevice() 获取单个设备
这是最常用的方式，适合用户主动选择设备的场景。该方法返回 Promise，成功后得到一个 BluetoothDevice 实例：
async function selectBluetoothDevice() {
try {
const device = await navigator.bluetooth.requestDevice({
acceptAllDevices: true,
optionalServices: ['battery_service'] // 可选，用于过滤
});
console.log('选中的设备:', device.name, device.id);
return device;
} catch (err) {
console.error('设备选择失败:', err.name, err.message);
throw err;
}
}
- 注意：必须在安全上下文（HTTPS 或 localhost）中运行
- 需用户手动授权并点击设备，不能后台自动扫描
- 返回的 Promise 在用户取消或拒绝权限时会 reject
用 Promise 包裹广告扫描（watchAdvertisements()）
Chrome 95+ 支持通过 watchAdvertisements() 持续监听附近广播的 BLE 设备，但它返回的是 AsyncIterator，不是 Promise。你可以用 Promise 封装“等待首个有效广告”逻辑：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
async function waitForFirstAdvertisement(timeoutMs = 5000) {
return new Promise((resolve, reject) => {
const controller = new AbortController();
const timeoutId = setTimeout(() => {
controller.abort();
reject(new Error('扫描超时'));
}, timeoutMs);
navigator.bluetooth.requestDevice({ acceptAllDevices: true })
.then(device => device.watchAdvertisements({ signal: controller.signal }))
.then(iterator => {
const onAdvertisement = async () => {
try {
const { value, done } = await iterator.next();
if (done) return;
console.log('收到广告:', value.device.name || value.device.id);
clearTimeout(timeoutId);
resolve(value.device);
} catch (e) {
if (e.name !== 'AbortError') reject(e);
}
};
onAdvertisement();
})
.catch(reject);
});
}
- 这个封装把“监听一次有效广告”变成了可 await 的 Promise
- 依赖
AbortController实现超时和提前终止 - 实际项目中建议加设备去重和信号强度过滤
批量扫描并 Promise.all 聚合多个设备（模拟“发现列表”）
标准 Web Bluetooth 不支持无交互式批量扫描，但可通过反复调用 requestDevice（配合不同过滤条件）或结合服务发现 + 广告解析来逼近效果。更实用的做法是用 Promise 链/数组控制扫描节奏：
立即学习“Java免费学习笔记（深入）”；
- 启动扫描前先检查
navigator.bluetooth是否可用 - 用
Promise.race()设置全局超时，避免卡死 - 将每次
device.gatt.connect()等后续操作也包装为 Promise，统一错误处理 - 使用
Set去重设备 ID，防止重复添加
常见陷阱与建议
- 不要在非 secure context 下调用，否则 Promise 直接 reject 并报错 “NotSupportedError”
- 用户未开启蓝牙时，
requestDevice的 Promise 会 pending 很久，建议加 UI 提示并提供手动重试 - Android Chrome 对后台广告监听有限制，iOS Safari 不支持 Web Bluetooth，需降级提示
- 扫描结果里的设备名可能为空（尤其未配对设备），优先用
device.id做唯一标识
