# @gmod/inflate 中文文档

规范地址：https://npmcn.com/package/%40gmod/inflate/

版本：1\.0\.0
npm 元数据更新时间：2026-08-17T02:06:30.777Z
中文译文更新时间：2026-11-16T17:12:35.258Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gmod/inflate
原文对照：https://npmcn.com/package/%40gmod/inflate/?lang=original
项目主页：https://github.com/GMOD/inflate-js#readme
源码仓库：https://github.com/GMOD/inflate-js

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：201 kB，18 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-08-17T02:01:40.279Z
- 最新版本发布：2026-08-17T02:06:30.576Z
- 近 30 天下载量：10875（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

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

## 安装

```sh
npm install @gmod/inflate
```

也可以使用：`pnpm add @gmod/inflate`、`yarn add @gmod/inflate`、`bun add @gmod/inflate`

## README

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

[![NPM version](https://img.shields.io/npm/v/@gmod/inflate.svg?style=flat-square)](https://npmjs.org/package/@gmod/inflate) ![Build Status](https://img.shields.io/github/actions/workflow/status/GMOD/inflate-js/publish.yml?branch=main)

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

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

## 安装

```
$ npm install @gmod/inflate
```

## 使用量

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

| 集装箱 | 形状 | 原子弹 |
| --- | --- | --: |
| [大维](https://github.com/GMOD/bbi-js/blob/main/docs/wasm.md#why-not-the-platforms-decompressionstream) | 数百个小街区 | 4- 11 个 |
| [隐藏](https://github.com/GMOD/hic/blob/main/docs/optimizations.md) | 少,多块 | ~2-7x 键 |
| [bgzf 数据](https://github.com/GMOD/bgzf-filehandle/blob/main/docs/optimizations.md) | 召集成员,1个电话 | ~2x 键 |

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

这也是唯一的 [自2023年5月以来的基线](https://web.dev/blog/compressionstreams) (萨法里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 是什么？

快速的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 和提交记录判断。

