Skip to content

ReadableStream ​

ReadableStream<T> é uma capacidade somente de leitura devolvida por adaptadores nativos, como leitura de arquivo e saída de processo filho.

AssinaturaReadableStream<T>

Métodos ​

MétodoAssinaturaFinalidade
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.