SerialPort: readable property
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The readable
read-only property of the SerialPort
interface returns a ReadableStream
for receiving data from the device connected to the port. Chunks read from this stream are instances of Uint8Array
. This property is non-null as long as the port is open and has not encountered a fatal error.
Value
Examples
The following example shows how to read data from a port. The outer loop handles non-fatal errors, creating a new reader until a fatal error is encountered and readable
becomes null
.
js
while (port.readable) {
const reader = port.readable.getReader();
try {
while (true) {
const { value, done } = await reader.read();
if (done) {
// |reader| has been canceled.
break;
}
// Do something with |value|…
}
} catch (error) {
// Handle |error|…
} finally {
reader.releaseLock();
}
}
Specifications
Specification |
---|
Web Serial API # dom-serialport-readable |
Browser compatibility
BCD tables only load in the browser