web serial api 可让网页通过用户授权与兼容串口电子秤通信,解析其ascii重量数据并自动填入表单;需设备为usb转串口(如ch340)、输出格式稳定、https环境,不支持蓝牙或usb hid秤。

Web Serial API 可以让网页直接与串口设备(如部分带USB转串口芯片的电子秤)通信,但需注意:不是所有电子秤都支持标准串口协议,且必须用户主动授权连接。实现自动录入表单的核心是监听串口数据、解析重量值、填入指定表单字段。
确认电子秤是否兼容 Web Serial
多数传统电子秤通过 RS232 或 USB 虚拟串口输出 ASCII 数据(如 "12.34 kg" 或 "000156 g"),需满足:
- 设备插入电脑后在系统中识别为串行端口(如 Windows 的 COM3,macOS/Linux 的 /dev/cu.usbserial-*)
- 输出格式稳定、有明确分隔(如回车
\r或换行\n) - 无需特殊驱动(CH340、CP2102、FTDI 类芯片通常可被浏览器识别)
⚠️ 注意:蓝牙电子秤、USB HID 协议秤(如多数 USB 直插“即插即用”型号)不适用 Web Serial,需改用 Web Bluetooth 或原生应用。
请求串口权限并建立连接
必须由用户点击触发(不能自动启动),示例代码:
let port;
async function connectSerial() {
try {
port = await navigator.serial.requestPort();
await port.open({ baudRate: 9600 }); // 常见波特率,按秤说明书调整
readSerialData();
} catch (err) {
console.error("连接失败:", err);
}
}
async function readSerialData() {
const reader = port.readable.getReader();
while (true) {
const { value, done } = await reader.read();
if (done) break;
if (value) {
const text = new TextDecoder().decode(value);
parseWeight(text); // 解析重量字符串
}
}
}
解析重量数据并填入表单
电子秤输出通常是连续流式文本,需按行或按终止符切分,并用正则提取数字。常见处理逻辑:
- 用
\r\n或\n分割多行数据 - 过滤空行和非数字行(如状态提示 "STABLE"、"ZEROING")
- 用正则匹配数字(支持小数点、负号):
/[-+]?\d*\.?\d+/ - 取最后一次有效读数(避免抖动),填入表单输入框(如
id="weight-input")
示例解析函数:
function parseWeight(raw) {
const lines = raw.split(/\r\n|\r|\n/);
for (const line of lines) {
const match = line.match(/[-+]?\d*\.?\d+/);
if (match && match[0]) {
const weight = parseFloat(match[0]);
if (!isNaN(weight) && weight > 0) {
document.getElementById("weight-input").value = weight.toFixed(2);
// 可选:触发 input/change 事件,使 Vue/React 等框架响应
document.getElementById("weight-input").dispatchEvent(new Event('input', { bubbles: true }));
}
}
}
}
补充建议与注意事项
实际使用中还需考虑:
- 防抖处理:电子秤可能连续发送相同值,可用时间戳或值比对避免频繁更新
- 单位统一:若输出含单位(如 "g"、"kg"),解析时一并识别并换算为统一单位(如全部转为 kg)
-
错误恢复:监听
port.onclose,提示用户重新连接;读取异常时调用reader.cancel() - 安全限制:Web Serial 仅在 HTTPS 环境(或 localhost)下可用,Chrome 89+ 支持,Edge 同步支持,Firefox/Safari 暂不支持
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











