html 无法直接操作蓝牙键盘，因其仅为标记语言；浏览器通过 document.addeventlistener('keydown') 统一处理输入事件，不区分设备类型；真正与蓝牙交互需依赖 web bluetooth api（仅限 https、用户触发、ble hid 设备且 chrome 支持），或原生应用。
HTML 里没有“函数”能直接操作蓝牙键盘
HTML 本身是标记语言，不提供任何键盘输入控制或设备通信能力。document.addEventListener('keydown') 这类事件监听的是浏览器接收到的输入事件，不管底层是蓝牙、USB 还是虚拟键盘——浏览器只管“收到了什么键”，不关心“怎么来的”。所谓“用 HTML 函数高效开发蓝牙键盘”，本质是误解了分层：蓝牙协议栈在操作系统和驱动层，Web API 只暴露标准化的输入事件流。
所以你没法用 HTML 或 DOM 方法去初始化蓝牙设备、读取信号强度、切换配对模式，或者绕过系统 HID 协议直接发指令。这些必须走原生应用（如 Electron + Node.js 蓝牙模块）或 Web Bluetooth API（但仅限支持该 API 的浏览器，且需用户手动授权、仅支持 BLE HID 设备）。
Web Bluetooth API 是唯一合法入口，但限制极多
如果你真想在网页里和蓝牙键盘交互（比如读取电池电量、切换 LED 模式），得用 navigator.bluetooth.requestDevice()，但它只对 BLE（低功耗蓝牙）设备有效，且要求：
- 页面必须运行在
https://或localhost下（file://直接报错） - 用户必须主动点击触发（不能自动弹窗）
- 设备必须广播 BLE HID Service（
00001812-0000-1000-8000-00805f9b34fb），而大多数消费级蓝牙键盘只走经典蓝牙 HID，不广播这个服务 - Chrome 89+ 支持，Firefox 和 Safari 完全不支持
示例片段（仅作示意，实际大概率失败）：
document.getElementById('connect').addEventListener('click', async () => {
try {
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }], // 键盘通常不带 battery_service
optionalServices: ['device_information', 'human_interface_device']
});
const server = await device.gatt.connect();
} catch (err) {
console.error(err); // 常见错误：<code>SecurityError</code>（非安全上下文）、<code>NotFoundError</code>（没找到匹配设备）
}
});
无线外设延迟测试，别信“HTML 函数”测出来的数字
用 performance.now() 记录 keydown 时间戳，再减去上一次 keyup，得到的只是“浏览器事件调度延迟”，不是“蓝牙空中延迟”。真实链路是：按键触发电磁波 → 蓝牙芯片编码 → 空中传输 → 主机蓝牙适配器解码 → HID 驱动注入 → 内核事件队列 → 浏览器合成 DOM 事件。中间任意一环卡顿（比如 USB 蓝牙狗被其他设备干扰、Windows 快速启动残留驱动、macOS 蓝牙固件 bug），都会污染结果。
可靠做法是用硬件工具（如 Saleae Logic + BLE 分析仪）抓空中包，或用双设备同步录像（一个拍键盘 LED，一个拍屏幕响应），靠帧数差反推端到端延迟。纯前端脚本测出来 12ms，实际可能 80ms——尤其在 Windows 上启用了 Bluetooth Support Service 自动重连逻辑时，首次按键延迟会突增。
真正提升开发效率的其实是系统级配置
与其折腾 Web API，不如调优蓝牙栈本身：
- Windows：禁用
Microsoft Bluetooth LE Enumerator（防止扫描干扰 HID 流量）；把蓝牙适配器插在 USB 2.0 口（USB 3.0 高频噪声常导致丢包） - macOS：终端执行
sudo defaults write /Library/Preferences/com.apple.Bluetooth ControllerPowerState -int 1强制保持控制器唤醒 - Linux：改
/etc/bluetooth/main.conf中的Enable=Source,Sink,Media,Socket，删掉Enable=LE（避免 BLE 扫描抢占 Classic HID 带宽）
这些调整带来的延迟下降，远比在 JS 里加个 requestIdleCallback 处理 keydown 明显得多。毕竟，Web 层永远在蓝牙协议栈最上面一层，它再快，也得等下面五层交完货才能开工。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
