在 javascript 异步错误处理中,async 函数捕获 hid(human interface device)相关错误的最直接方式是在调用 hid api 的语句前包裹 try...catch 块。由于 hid 操作通常涉及硬件交互或权限验证,这些操作会抛出 domexception 或 typeerror,通过 await 关键字挂起执行并立即进入 catch 分支,可以确保错误被同步捕获并处理。具体做法是获取 hid 设备实例后,对 open、sendreport 或 getfeaturereport 等方法进行 await 调用,一旦失败,catch 块即可接收具体的 error 对象。

HID API 调用时哪些异常会被抛出
HID API 在浏览器环境中主要抛出两类异常:一是用户未授权或设备断开连接导致的 SecurityError 和 NotFoundError,二是参数错误或设备无响应导致的 TypeError。当使用 navigator.hid.requestDevice() 请求设备时,如果用户拒绝授权,Promise 会直接 reject;而在后续通信中,如果设备突然拔出,device.open() 会抛出异常。这些异常都是标准的 JavaScript Error 对象,包含 message 和 name 属性,便于区分错误类型。

const device = await navigator.hid.requestDevice({ filters: [{ usagePage: 0xFF00, usage: 0x0001 }] });
try {
await device.open();
const reportId = 1;
const data = new Uint8Array([reportId, 0x01]);
await device.sendReport(reportId, data);
} catch (error) {
console.error(`HID Error: ${error.name} - ${error.message}`);
}
上述代码展示了完整的 HID 操作流程。首先通过 requestDevice 获取设备,然后尝试打开连接并发送数据。如果在任何一步发生错误,例如设备未就绪或权限不足,程序会跳转到 catch 块,打印出具体的错误名称和消息。这种结构确保了即使硬件层出现不可预见的故障,JavaScript 运行时也不会崩溃,而是能够优雅地降级或提示用户。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何根据错误类型区分处理 HID 故障
区分 HID 故障的关键在于检查 error.name 属性的值。不同的错误名称对应不同的恢复策略,例如 SecurityError 通常需要重新请求权限,而 NotFoundError 可能意味着需要重新扫描设备。通过 switch 语句或 if-else 链,可以将错误分类处理,避免将所有错误混为一谈。此外,对于某些可恢复的错误,如短暂的通信超时,可以在 catch 块中加入重试逻辑,提高系统的鲁棒性。

try {
await device.open();
await device.sendReport(1, new Uint8Array([1]));
} catch (error) {
switch (error.name) {
case 'SecurityError':
console.log('Permission denied, please re-authorize.');
break;
case 'NotFoundError':
console.log('Device disconnected, scanning for new devices...');
// 触发重新扫描逻辑
break;
default:
console.error('Unknown error:', error);
}
}
这段代码演示了基于错误类型的差异化处理。当捕获到 SecurityError 时,提示用户重新授权;当捕获到 NotFoundError 时,触发重新扫描设备的逻辑。这种处理方式使得应用能够根据具体的故障原因采取相应的措施,而不是简单地终止运行。同时,default 分支用于处理未预期的错误,确保所有异常情况都有日志记录,便于后续调试和分析。
设备断开连接时 async 函数的状态变化
当 HID 设备在通信过程中突然断开连接时,async 函数中的 await 表达式会立即抛出 NotFoundError 或类似的 I/O 错误。此时,函数的执行流会从挂起状态直接进入 catch 块,后续的代码不再执行。这意味着开发者不需要手动检查设备是否在线,只需在错误处理中考虑重连或清理资源即可。这种机制简化了异步编程中的状态管理,避免了复杂的轮询或回调嵌套。

















