SerialPort: readable-Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Dedicated Web Workers verfügbar.
Die readable-Eigenschaft der SerialPort-Schnittstelle ist eine schreibgeschützte Eigenschaft, die einen ReadableStream zurückgibt, um Daten von dem Gerät zu empfangen, das mit dem Port verbunden ist. Die aus diesem Stream gelesenen Blöcke sind Instanzen von Uint8Array. Diese Eigenschaft ist nicht null, sofern der Port geöffnet ist und kein schwerwiegender Fehler aufgetreten ist.
Wert
Ein ReadableStream.
Beispiele
Das folgende Beispiel zeigt, wie man Daten von einem Port liest. Die äußere Schleife behandelt nicht-schwerwiegende Fehler und erstellt einen neuen Leser, bis ein schwerwiegender Fehler auftritt und readable null wird.
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();
}
}
Spezifikationen
| Spezifikation |
|---|
| Web Serial API # dom-serialport-readable |