Skip to content

decompress ​

decompress restaura bytes producidos por compress o por cualquier otra implementación de Gzip, zlib, Deflate crudo o Brotli. Sin format, identifica Gzip y Deflate por sus firmas; Brotli y Deflate crudo no tienen firma y necesitan format.

Los límites se comprueban mientras se produce la salida, nunca después, así que una bomba de descompresión se detiene en el límite en lugar de llenar la memoria. maxRatio solo se aplica después del primer 1 MiB de salida, ya que las entradas pequeñas se expanden legítimamente por factores grandes.

Firmadecompress(data: u8[], options?: DecompressOptions): Promise<Result<u8[], CompressError>>

Ejemplo mínimo ​

tyrus
import { CompressError, CompressFormat, compress, decompress } from "tyrus:compress";

async function restore(): Promise<Result<void, CompressError>> {
    const packed: u8[] = await compress("Hello, Tyrus!", CompressFormat.Gzip)?;
    const original: u8[] = await decompress(packed)?;
    print(original.length); // 13
    return Ok();
}

Todas las opciones ​

tyrus
import { CompressError, CompressFormat, DecompressOptions, decompress } from "tyrus:compress";

async function restore(packed: u8[]): Promise<Result<void, CompressError>> {
    const original: u8[] = await decompress(packed, {
        format: CompressFormat.Brotli, // required for Brotli and DeflateRaw; default detected from the data
        maxOutputBytes: 64_000_000, // refuse more output than this; default 256 MiB
        maxRatio: 1_000, // refuse more than this expansion once past 1 MiB; default 200
    })?;
    print(original.length); // 13
    return Ok();
}

Un format que no coincide con los datos falla con ERR_COMPRESS_INVALID_DATA, y un límite 0 falla con ERR_COMPRESS_INVALID_OPTION: las opciones aumentan los límites, nunca los desactivan.