ID: WEB-SERIAL-03
Web Serial API 浏览器接口与配置 (Browser API)
Chrome / Edge 串口兼容:Web Serial 启用与浏览器支持说明
打开在线串口调试工具
需 Chrome / Edge 桌面浏览器 · 串口数据仅在本地处理
Web Serial API 目前主要跑在 Chromium 桌面浏览器:Google Chrome、Microsoft Edge、部分 Opera 新版本。Firefox、Safari 出于安全与策略考虑,尚未提供同等原生能力。
版本与开关
- Chrome / Edge 89+ 起默认可用(以实际发行说明为准)。
- 极旧 Chromium 可在 chrome://flags 搜索 experimental web platform features 临时开启。
- 页面必须在 HTTPS 或 localhost;否则 navigator.serial 为 undefined。
- iframe 嵌入需 allow="serial"。
兼容性自检
1. 桌面 Chrome/Edge 打开站点。
2. 控制台输入 navigator.serial 是否存在。
3. 点击连接是否弹出系统端口选择器。
4. 移动端、微信内置浏览器、多数安卓 WebView:不要预期可用。
产品提示 对不支持的环境,应明确提示「请使用电脑版 Chrome 或 Edge」,并提供在新标签打开、驱动安装文档链接。Web Serial Pro 亦按此策略引导用户,避免把「浏览器不支持」误判成「串口坏了」或「驱动没装」。
打开在线串口调试工具
在本页完成排查后,用网页串口直接验证收发