SerialPort:setSignals() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

注意:此功能在 专用 Web Workers 中可用。

SerialPort 接口的 setSignals() 方法用于设置端口上的控制信号,并返回一个 Promise,该 Promise 在信号设置完成后解析。

语法

js
setSignals()
setSignals(options)

参数

options 可选

一个包含以下任一值的对象:

dataTerminalReady

一个布尔值,指示是否调用操作系统来断言(如果为 true)或撤销(如果为 false)串行端口上的“数据终端就绪”或“DTR”信号。

requestToSend

一个布尔值,指示是否调用操作系统来断言(如果为 true)或撤销(如果为 false)串行端口上的“发送请求”或“RTS”信号。

break

一个布尔值,指示是否调用操作系统来断言(如果为 true)或撤销(如果为 false)串行端口上的“break”信号。

返回值

Promise

异常

InvalidStateError DOMException

如果端口未打开,则返回此错误。请调用 SerialPort.open() 来避免此错误。

NetworkError DOMException

如果设备上的信号无法设置,则返回此错误。

规范

规范
Web Serial API
# dom-serialport-setsignals

浏览器兼容性