ReadableStream
ReadableStream<T> é uma capacidade somente de leitura devolvida por adaptadores nativos, como leitura de arquivo e saída de processo filho.
Assinatura
ReadableStream<T>Métodos
| Método | Assinatura | Finalidade |
|---|---|---|
read | () => Promise<T?> | Resolve com o próximo valor ou vazio no fim do stream. |
pipeTo | (destination: WritableStream<T>) => Promise<void> | Copia valores progressivamente e fecha o destino após EOF normal. |
close | () => Promise<void> | Abandona valores não lidos e acorda 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);
}Erros
read(), pipeTo() e close() rejeitam com StreamError quando o stream falha ou uma operação viola seu ciclo de vida. pipeTo() preserva o erro estruturado gerado pela origem ou destino. Cancelar uma operação pipeTo() pendente faz as duas pontas falharem com ERR_STREAM_CANCELLED e descarta os chunks em buffer.
