SerialPort.readable
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
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.
Syntax
var readableStream = SerialPort.readable;
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
.
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
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
readable |
89 |
89 |
No |
No |
No |
No |
No |
No |
No |
No |
No |
No |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SerialPort/readable