捕获 web serial 异步错误最直接的方法是在调用 serialport.open() 等返回 promise 的 api 时，使用 try...catch 块包裹代码。由于这些操作是异步的，必须通过 await 关键字等待其完成，这样当连接失败、权限被拒或设备断开时，异常才会被抛出并进入 catch 分支进行处理。
如何区分不同的串口连接错误类型
在 catch 块中，可以通过检查抛出的 Error 对象的具体属性来区分错误类型。例如，DOMException 通常包含 name 属性（如 "SecurityError" 或 "NotFoundError"），而网络断开则可能触发 SerialPort 实例上的 onerror 事件。针对连接阶段的错误，主要依赖 try...catch 捕获的异常信息来判断是用户取消了选择还是设备不存在。
async function connectToSerial() {
try {
// 请求用户选择串口
const port = await navigator.serial.requestPort();
// 尝试打开串口，设置超时和波特率
await port.open({ baudRate: 9600 });
console.log('串口连接成功');
// 监听数据读取
const reader = port.readable.getReader();
while (true) {
const { value, done } = await reader.read();
if (done) break;
console.log('收到数据:', value);
}
} catch (error) {
if (error.name === 'SecurityError') {
console.error('权限被拒绝：请确保 HTTPS 环境');
} else if (error.name === 'NotFoundError') {
console.error('未找到设备或用户取消选择');
} else {
console.error('其他错误:', error.message);
}
}
}
上述代码展示了完整的连接流程。当用户点击按钮触发 connectToSerial 时，如果浏览器处于非安全上下文（HTTP），requestPort 会立即抛出 SecurityError。如果用户关闭了选择窗口，则会抛出 AbortError。这些具体的错误名称允许开发者提供针对性的 UI 提示。
如何处理运行时的串口断开与读写错误
一旦串口成功打开，后续的读写操作可能会因为物理断开或硬件故障而失败。此时，try...catch 无法直接捕获发生在后台流中的错误，必须为 SerialPort 实例绑定 onerror 事件处理器。该处理器会在发生 I/O 错误时被调用，接收一个包含错误详情的参数，从而允许程序在不崩溃的情况下进行清理或重试。
// 假设 port 已经成功打开
port.addEventListener('error', (event) => {
console.error('串口运行时错误:', event.error);
// 执行清理逻辑，例如关闭读取器
if (reader) {
reader.cancel().then(() => {
console.log('读取器已取消');
});
}
});
// 或者在读取循环中捕获
try {
while (true) {
const { value, done } = await reader.read();
if (done) break;
// 处理数据
}
} catch (readError) {
console.error('读取过程中出错:', readError);
}
在实际应用中，建议同时使用 onerror 事件和 try...catch 包裹读取循环。前者能捕获底层驱动级别的突发错误，后者能处理 JavaScript 层面的逻辑中断。这种双重保障确保了即使设备突然拔除，应用也能优雅地退出循环并释放资源。
为什么在 HTTP 环境下 requestPort 会直接报错
Web Serial API 出于安全考虑，严格限制在非安全上下文（即 HTTP）中使用。如果在 HTTP 页面中调用 navigator.serial.requestPort()，浏览器不会弹出设备选择框，而是直接抛出一个 SecurityError。这是浏览器的强制行为，旨在防止中间人攻击窃取敏感串口数据。因此，在开发阶段必须使用 localhost 或切换到 HTTPS 进行测试。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
