WebUSB API允许JavaScript在浏览器中安全连接USB设备，需HTTPS环境及用户授权，支持Chrome 61+等Chromium内核浏览器，通过requestDevice、open、selectConfiguration、claimInterface、transferIn/Out实现通信，适用于Arduino等开发板调试；限制包括仅部分浏览器支持、需手动触发连接、设备合规性要求，替代方案Node.js结合node-usb模块可实现更强大控制，适合桌面应用，且应遵循最小权限原则确保安全。
JavaScript 本身无法直接与 USB 设备通信，因为浏览器出于安全考虑限制了对底层硬件的访问。但现代 Web 平台提供了一些标准化 API，可以在特定条件下实现与 USB 设备的安全交互。
WebUSB API：在浏览器中连接 USB 设备
WebUSB 是 W3C 提出的一项实验性标准，允许网页通过 JavaScript 安全地与 USB 设备通信。它支持 Chrome 61+ 及基于 Chromium 的浏览器（如 Edge、Opera），但 Firefox 和 Safari 尚未支持。
使用 WebUSB 需要用户主动授权，并且页面必须运行在 HTTPS 环境下（本地开发可使用 localhost）。
以下为基本使用流程：- 请求设备连接：调用 navigator.usb.requestDevice() 并传入过滤条件（如 vendorId、productId）
- 打开设备：获取设备实例后调用 .open() 方法
- 选择配置和接口：通常使用 .selectConfiguration() 和 .claimInterface()
- 数据传输：使用 .transferIn() 和 .transferOut() 进行控制或批量传输
示例代码：
立即学习“Java免费学习笔记（深入）”；
async function connectUSB() {
try {
// 请求指定设备
const device = await navigator.usb.requestDevice({ filters: [{ vendorId: 0x1234 }] });
await device.open();
await device.selectConfiguration(1);
await device.claimInterface(0);
// 发送数据（写）
const data = new Uint8Array([0x01, 0x02, 0x03]);
await device.transferOut(1, data);
// 接收数据（读）
const result = await device.transferIn(1, 64);
console.log('收到:', new Uint8Array(result.data.buffer));
} catch (err) {
console.error('USB 错误:', err);
}
}
适用场景与限制
WebUSB 适合需要轻量级控制的场景，例如开发板调试（如 Arduino、STM32）、自定义外设（键盘、传感器）、教育类项目等。
主要限制包括：
- 仅限支持 WebUSB 的浏览器
- 必须由用户手动触发连接操作（不能自动连接）
- 设备需符合 USB 通信规范，且驱动兼容
- 部分操作系统可能需要额外配置权限
替代方案：Node.js + node-usb
若需更强控制力或脱离浏览器环境，可在 Electron 或 Node.js 中使用 node-usb 模块。
该模块提供完整的 libusb 功能封装，支持更复杂的设备操作，适用于桌面应用开发。
安装方式：npm install usb
特点：
- 支持 Windows、macOS、Linux
- 可访问所有接口和端点
- 无需浏览器兼容性顾虑
- 适合构建专用控制软件
安全注意事项
无论是 WebUSB 还是 node-usb，都应遵循最小权限原则：
- 只请求必要的设备访问权限
- 验证设备身份（vendorId/productId）防止误操作
- 避免长时间持有设备连接
- 处理好异常断开情况
基本上就这些。WebUSB 让前端直接控制硬件成为可能，虽然目前生态有限，但在特定领域已具备实用价值。对于复杂需求，结合 Electron 使用 node-usb 更加灵活可靠。
