Skip to content

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.