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.
Assinatura
decompress(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.
