Skip to content

decompress ​

decompress restaura bytes produzidos por compress ou por qualquer outra implementação de Gzip, zlib, Deflate cru ou Brotli. Sem format, identifica Gzip e Deflate pelas assinaturas; Brotli e Deflate cru não têm assinatura e precisam de format.

Os limites são verificados enquanto a saída é produzida, nunca depois, então uma bomba de descompressão para no limite em vez de encher a memória. maxRatio só vale depois do primeiro 1 MiB de saída, já que entradas pequenas legitimamente se expandem por fatores grandes.

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

Exemplo 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 as opções ​

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();
}

Um format que não confere com os dados falha com ERR_COMPRESS_INVALID_DATA, e um limite 0 falha com ERR_COMPRESS_INVALID_OPTION: as opções aumentam os limites, nunca os desligam.