writeFileStream
writeFileStream cria ou trunca um arquivo e retorna um Result<WritableStream<u8[]>, FsError> limitado. O backpressure impede que produtores mantenham toda a saída na memória.
Assinatura
tyrus
function writeFileStream(path: string): Result<WritableStream<u8[]>, FsError>A fila comporta no máximo 256 KiB. await stream.close() e await source.pipeTo(stream) resolvem somente depois que todos os chunks aceitos foram escritos e o buffer do arquivo foi descarregado.
Exemplo
tyrus
import { FsError, writeFileStream } from "tyrus:fs";
import { WritableStream } from "tyrus:stream";
match (writeFileStream("archive.bin")) {
Ok(stream) => { print("output stream opened"); } // output stream opened
Err(error) => { printError(error.code); } // ERR_FS_WRITE_FAILED
}Falhas ao abrir retornam Err(FsError). Falhas de escrita ou flush rejeitam operações do stream com StreamError.
