@andrewbranch/untar.js

中文文档
1.0.4发布于 2026/08/06MITTypeScriptESM + CJS零依赖近 30 天下载 490.6万

untar salvaged from bitjs

原始使用文档

untar.js

Here's a simple pure-javascript implementation of untar (it's mostly taken verbatim from Jeff Schiller's bitjs, but no longer in a webworker— though ironically I'm making this in order to stick it back in a webworker, but I digress).

Here's a basic usage, it seems to work alright.

var untar = require('untar.js');
var fs = require('fs');

var file = fs.readFileSync(__dirname + '/' + 'test.tar');
untar.untar(file).forEach(function(file){
    console.log(file.filename, file.fileData.length);
})

It's also possible to combine this with pako in order to decode tarballs

var untar = require('untar.js')
var pako = require('pako')
var fs = require('fs')

var unzipped = pako.inflate(fs.readFileSync(__dirname + '/' + 'with-5.0.0.tgz'));

untar.untar(unzipped).map(function(file){
    console.log(file.filename)
})

It's pretty minimal as far as APIs go, it exposes a single method untar which can be passed an ArrayBuffer. It returns a list of TarLocalFile objects. The important fields are size, filename, and fileData.

Changelog

  • 0.2.3 — Fixing #2, thanks @jedie!
  • 0.2.2 — Fixing more decode bugs
  • 0.2.0 — Fixed a pretty major bug which led to decode errors from rounding to the wrong block.
  • 0.1.0 — Initial Release

版本与发布记录

@andrewbranch/untar.js 共发布 5 个版本,首次发布于 2023/02/24;过去 12 个月发布了 1 个版本。

版本发布日期距今
1.0.4latest2026/08/063 个月前
1.0.32023/10/153 年前
1.0.22023/02/243 年前
1.0.12023/02/243 年前
1.0.02023/02/243 年前

关于 @andrewbranch/untar.js 的常见问题

@andrewbranch/untar.js 是什么?

untar salvaged from bitjs

如何安装 @andrewbranch/untar.js?

在项目目录运行 npm install @andrewbranch/untar.js,或使用 pnpm add / yarn add / bun add。

@andrewbranch/untar.js 支持 TypeScript 吗?

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

@andrewbranch/untar.js 支持 ESM 还是 CommonJS?

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

@andrewbranch/untar.js 可以商用吗?

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

@andrewbranch/untar.js 的下载量有多少?

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

@andrewbranch/untar.js 还在维护吗?

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