ReadableStream
ReadableStream<T> es una capacidad de solo lectura devuelta por adaptadores nativos, como lectura de archivos y salida de procesos hijo.
Firma
ReadableStream<T>Métodos
| Método | Firma | Finalidad |
|---|---|---|
read | () => Promise<T?> | Se resuelve con el siguiente valor o vacío al final del stream. |
pipeTo | (destination: WritableStream<T>) => Promise<void> | Copia valores progresivamente y cierra el destino después de EOF normal. |
close | () => Promise<void> | Abandona valores no leídos y despierta escritores bloqueados. |
Uso
tyrus
async function consume(stream: ReadableStream<u8[]>, destination: WritableStream<u8[]>): Promise<void> {
const first: u8[]? = await stream.read();
if (first) {
await destination.write(first);
}
await stream.pipeTo(destination);
}error
tyrus
async function invalid(readable: ReadableStream<u8[]>, bytes: u8[]): Promise<void> {
await readable.write(bytes);
}Errores
read(), pipeTo() y close() rechazan con StreamError cuando el stream ha fallado o una operación viola su ciclo de vida. pipeTo() conserva el error estructurado producido por su origen o destino. Cancelar una operación pipeTo() pendiente hace que ambos extremos fallen con ERR_STREAM_CANCELLED y descarta los fragmentos almacenados en el búfer.
