@gmod/inflate

中文文档
1.0.0发布于 2026/08/17MITTypeScriptESM + CJS零依赖近 30 天下载 1.1万

快速的DEFLATE 解压通过 libdeflate , 作为单捆

中文使用文档
文档目录10 节
  1. 安装
  2. 使用量
  3. API 密码
  4. inflateRaw(input, outputSize): Promise<Uint8Array>
  5. inflateRawUnknownSize(input): Promise<Uint8Array>
  6. inflateRawBatch(inputs, offsets, lengths, maxBlockSize): Pr…
  7. 诚信
  8. 为什么不呢 DecompressionStream ? 吗?
  9. 大楼
  10. 许可证

@ gmod/ flate (中文(简体) )

NPM version Build Status

通过一个电站解压 无罪释放 新建, 一体运出 将自成一体的捆绑在被线内作为基准64——没有单独的 .wasm 获取, 不为消费者建工具 .

它特别存在于一种形状上: 一个单独持有数百个文件的文件 压缩块. inflateRawBatch 将一整圈地充气 JS"WASM"横跨,这是平台的 DecompressionStream 没办法, 和大约4x快于pako 在块大小 基因组学格式使用.

安装

$ npm install @gmod/inflate

使用量

import { inflateRaw, inflateRawBatch } from '@gmod/inflate'

// One block, size known from an index
const plain = await inflateRaw(rawDeflateBytes, uncompressedSize)

// A run of blocks packed in one buffer — one crossing for all of them
const { data, offsets } = await inflateRawBatch(
  buffer, // concatenated compressed bytes
  new Uint32Array([0, 512, 1400]), // where each block starts
  new Uint32Array([512, 888, 640]), // how long each is
  65536, // the largest any one inflates to
)
for (let i = 0; i < offsets.length - 1; i++) {
  const block = data.subarray(offsets[i], offsets[i + 1])
}

在第一次通话时, 原模组即时化为懒惰, 从那时开始共享 因此,没有什么可以初始化 和没有撕裂.

API 密码

inflateRaw(input, outputSize): Promise<Uint8Array>

一个 原发 流,其未压缩大小已经知道。 这是 路径 : libdeflate 直接写入一个完全大小的缓冲器 没有生长回路 没有流体状态 记录未压缩格式 他们的指数的大小, .hic,bgzf——可以永远使用.

input 不可包含 zlib 标题。 如果您的字节以一个开头( I)0x78, (中文(简体) ), 通过 input.subarray(2)。 。 。 .

inflateRawUnknownSize(input): Promise<Uint8Array>

同样,当大小没有记录时. 双打猜到合得来,所以 费用每翻一番就再涨一分 偏爱 inflateRaw 在你能够.

inflateRawBatch(inputs, offsets, lengths, maxBlockSize): Promise<BatchResult>

很多街区,一个电话. inputs 是被压缩的字节,并且 offsets编号 :lengths (两者) Uint32Array找到每个街区. maxBlockSize 是每个区块充气的最大尺寸.

与 inflateRaw,每个街区在这里 实值 预期将携带 2字节 zlib 头; 被机跳过内部 .

回返 { data, offsets }时 data 是每个区块的字节 财务报告和审定财务报表 offsets 已经 blocks + 1 标记,所以块 i 实值 data.subarray(offsets[i], offsets[i + 1])。 。 。 .

诚信

原始卸载 无校验和 - zlib的阿德勒32住在4字节拖车里 这些入口跳过。 腐败仍然形成法律的分流 解码为错误的字节,没有出错。 需要正直的呼叫者应当 从他们的容器中取出: bgzf 的每块 CRC, 或不匹配 未压缩大小的索引记录 .

腐败输入,即 没有 法律流 拒绝正常, 和原声 实例仍可用于以后的通话.

为什么不呢 DecompressionStream? 吗?

从2023年起,这个平台就有一个, 对于一个大的缓冲器来说,这是一个罚款 答话 对于一个包含许多小块的文件来说,它不是:它的成本以一个小块为主 固定的每个呼叫机头,一个呼叫器必须达到每个街区一次. 计量 由容器的形状决定结果:

集装箱形状原子弹
大维数百个小街区4- 11 个
隐藏少,多块~2-7x 键
bgzf 数据召集成员,1个电话~2x 键

inflateRawBatch 支付过路费一次 整个团体.

这也是唯一的 自2023年5月以来的基线 (萨法里16.4), Firefox 113),所以不管怎样,一个倒下的船只——它移除了剩下的一艘 参数, 捆绑保存 .

大楼

跟踪 src/wasm/inflate-wasm-inlined.js 并重建它 需要一个 Rust 工具链加 wasm-bindgen-cli数字 :

$ pnpm build:wasm

它必须重建字节 preversion 运行 pnpm build,所以一个 非可复制捆绑意味着 npm version 静静地做一件文物 没有人审查过, 半途而废. git status 清除后 pnpm build:wasm 这是支票.

许可证

麻省理工学院

版本与发布记录

@gmod/inflate 共发布 2 个版本,首次发布于 2026/08/17;过去 12 个月发布了 2 个版本。

版本发布日期距今
1.0.0latest2026/08/172 个月前
0.0.02026/08/172 个月前

关于 @gmod/inflate 的常见问题

@gmod/inflate 是什么?

快速的DEFLATE 解压通过 libdeflate , 作为单捆

如何安装 @gmod/inflate?

在项目目录运行 npm install @gmod/inflate,或使用 pnpm add / yarn add / bun add。

@gmod/inflate 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gmod/inflate 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@gmod/inflate 可以商用吗?

@gmod/inflate 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gmod/inflate 的下载量有多少?

根据 npm 官方下载统计,@gmod/inflate 在 2026/10/17 – 2026/11/15 这 30 天内被下载 10,875 次,日均约 363 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gmod/inflate 还在维护吗?

最新版本 1.0.0 发布于 2026/08/17(2 个月前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/08/17。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。