compressionStream
compressionStream devuelve un TransformStream<u8[], u8[]>: los bytes escritos en su lado writable salen comprimidos por su lado readable, en el formato indicado. Nunca guarda la entrada ni la salida completas, así que un archivo de cualquier tamaño se comprime con memoria constante, y un lector lento frena al escritor en lugar de dejar que los datos se acumulen.
Firma
compressionStream(format: CompressFormat, options?: CompressOptions): TransformStream<u8[], u8[]>Ejemplo mínimo
tyrus
import { CompressFormat, compressionStream } from "tyrus:compress";
import { readFileStream, writeFileStream } from "tyrus:fs";
import { TransformStream } from "tyrus:stream";
async function compressLog(): Promise<void> {
try {
const gzip: TransformStream<u8[], u8[]> = compressionStream(CompressFormat.Gzip);
const feeding = readFileStream("./app.log").pipeTo(gzip.writable);
const draining = gzip.readable.pipeTo(writeFileStream("./app.log.gz"));
await feeding;
await draining;
print("compressed"); // compressed
} catch (error: Error) {
printError(error.message);
}
}Todas las opciones
tyrus
import { CompressFormat, CompressOptions, compressionStream } from "tyrus:compress";
import { TransformStream } from "tyrus:stream";
async function compressChunks(): Promise<void> {
const brotli: TransformStream<u8[], u8[]> = compressionStream(CompressFormat.Brotli, {
level: 9, // 0 to 11 for Brotli, 0 to 9 for the others; default 6
});
await brotli.writable.write([116, 121, 114, 117, 115]);
await brotli.writable.close();
const first: u8[]? = await brotli.readable.read();
print((first ?? []).length > 0); // true
}Errores
Un fallo llega a ambos lados como un CompressError: read() en la salida y write() o close() en la entrada rechazan con él, y catch (error: CompressError) lo recibe. Un level fuera del rango del formato hace que el stream falle en su primer uso con ERR_COMPRESS_INVALID_LEVEL; uno literal se rechaza al compilar (E3312).
