tar

インストール

const tar = require('archive/tar');

tarSync()

TARアーカイブを同期的に作成します。

構文

tarSync(data)

パラメーター

data String | ArrayBuffer | Uint8Array | Number[] | Object[]

dataが単一の文字列またはバイトバッファーの場合、作成するエントリの既定の名前はdataです。配列を渡す場合は、各要素を{ name, data }形式のエントリオブジェクトとして扱います。

戻り値

TARアーカイブのバイト列を含むArrayBufferを返します。

簡単なテストや、メモリ上でアーカイブを作成してから別の場所に保存する場合に便利です。

使用例

1
2
3
4
5
6
const tar = require('archive/tar');
const archive = tar.tarSync([
	{ name: 'alpha.txt', data: 'Alpha' },
	{ name: 'dir/beta.txt', data: 'Beta' }
]);
console.println(archive.constructor.name);

1
2
3
4
const tar = require('archive/tar');
const archive = tar.tarSync('hello tar');
const entries = tar.untarSync(archive);
console.println(entries[0].name, new Uint8Array(entries[0].data).length);

untarSync()

TARアーカイブのバイト列を同期的に展開し、エントリオブジェクトの配列を返します。

構文

untarSync(buffer)

パラメーター

buffer ArrayBuffer | Uint8Array | Number[]

戻り値

エントリオブジェクトの配列を返します。

各エントリには、name、data、mode、size、isDir、modified、typeflag、type、 linknameフィールドを含む場合があります。

使用例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
const tar = require('archive/tar');
const archive = tar.tarSync([
	{ name: 'assets', isDir: true, type: 'dir' },
	{ name: 'assets/readme.txt', data: 'hello' },
	{ name: 'current', type: 'symlink', linkname: 'assets/readme.txt' }
]);
const entries = tar.untarSync(archive);
console.println(entries[0].name, entries[0].isDir, entries[0].type);
console.println(entries[1].name, entries[1].size, entries[1].type);
console.println(entries[2].name, entries[2].type, entries[2].linkname);

tar()

TAR作成機能の、コールバック形式の非同期ラッパーです。

構文

tar(data, callback)

コールバックのシグネチャは(err, archive)です。

untar()

TAR展開機能の、コールバック形式の非同期ラッパーです。

構文

untar(buffer, callback)

コールバックのシグネチャは(err, entries)です。

ストリームイベントを直接管理せずに、コールバック方式で処理する場合に適しています。

使用例

1
2
3
4
5
6
7
8
9
const tar = require('archive/tar');

tar.tar('payload', function(err, archive) {
	if (err) throw err;
	tar.untar(archive, function(err2, entries) {
		if (err2) throw err2;
		console.println(entries[0].name, new Uint8Array(entries[0].data).length);
	});
});

createTar()

ストリーム形式のTAR writerを作成します。

返されるオブジェクトは、write()でエントリを受け取り、end()が呼び出されると、dataイベントでアーカイブのバイト列を出力します。

このAPIはイベント駆動ですが、Node.jsのファイルストリームのように中間結果を逐次出力せず、end()の時点で処理を完了します。

構文

createTar()

createUntar()

ストリーム形式のTAR readerを作成します。

アーカイブのバイト列をwrite()で渡してからend()を呼び出すと、展開した項目ごとにentryイベントが発生します。

構文

createUntar()

使用例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
const tar = require('archive/tar');
const writer = tar.createTar();
let archive = null;

writer.on('data', function(chunk) {
	archive = chunk;
});

writer.on('end', function() {
	const reader = tar.createUntar();
	reader.on('entry', function(entry) {
		const text = String.fromCharCode.apply(null, new Uint8Array(entry.data));
		console.println(entry.name + '=' + text);
	});
	reader.write(archive);
	reader.end();
});

writer.write({ name: 'one.txt', data: 'One' });
writer.write({ name: 'two.txt', data: 'Two' });
writer.end();

Tarは、TARアーカイブの作成、保存、読み込み、展開を行うファイル指向のヘルパークラスです。

コンストラクター

new tar.Tar(filePath?)

filePathを指定すると、そのファイルからアーカイブを読み込みます。

addFile()

ファイルシステムのファイルを読み込み、アーカイブエントリとして追加します。

addFile(filePath[, entryName])

addBuffer()

文字列またはバイトバッファーを、アーカイブエントリとして追加します。

addBuffer(data, entryName[, options])

addEntry()

エントリオブジェクトを直接追加します。

addEntry(entry)

対応するTARエントリのフィールドは以下のとおりです。

name String 必須のエントリパス
data String | ArrayBuffer | Uint8Array | Number[] ファイルの内容
mode Number ファイルモード
modified Date 更新時刻
type String 例：file、dir、symlink、link
typeflag Number 生のTARタイプフラグ
linkname String symlinkまたはlinkのリンク先パス
isDir Boolean ディレクトリエントリかどうか

addFile()は、ディスク上にあるファイルをまとめる最も簡単な方法です。 addBuffer()は、メモリ上で生成した内容を直接追加する場合に適しています。 addEntry()は、ディレクトリエントリやリンクのメタデータなど、TAR固有のプロパティが必要な場合に使用します。

getEntries()

現在のアーカイブエントリの浅いコピーを返します。

getEntries()

writeTo()

アーカイブをファイルに保存します。

writeTo(filePath)

extractAllTo()

エントリをディレクトリに展開します。

extractAllTo(outputDir[, overwrite])
extractAllTo(outputDir, options)
extractAllTo(outputDir, overwrite, options)

optionsは、以下の値に対応しています。

overwrite Boolean trueの場合、既存のファイルを上書きします。
filter Function | RegExp | String | String[] 展開するエントリを選択します。

使用例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
const tar = require('archive/tar');

const t = new tar.Tar();
t.addEntry({ name: 'docs', isDir: true, type: 'dir' });
t.addEntry({ name: 'docs/readme.txt', data: 'hello tar' });
t.addEntry({ name: 'latest', type: 'symlink', linkname: 'docs/readme.txt' });
t.writeTo('/tmp/bundle.tar');

const saved = new tar.Tar('/tmp/bundle.tar');
saved.extractAllTo('/tmp/out', {
	overwrite: true,
	filter: function(entry) {
		return entry.name.endsWith('.txt');
	}
});

使用例: ファイルをまとめて再展開する

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
const fs = require('fs');
const tar = require('archive/tar');
const base = '/tmp/tar-files';

fs.mkdir(base + '/input', { recursive: true });
fs.writeFile(base + '/input/one.txt', 'One', 'utf8');
fs.writeFile(base + '/input/two.txt', 'Two', 'utf8');

const archive = new tar.Tar();
archive.addFile(base + '/input/one.txt');
archive.addFile(base + '/input/two.txt', 'renamed-two.txt');
archive.writeTo(base + '/sample.tar');

const loaded = new tar.Tar(base + '/sample.tar');
loaded.extractAllTo(base + '/out', true);
console.println(fs.readFile(base + '/out/renamed-two.txt', 'utf8'));

使用例: 条件付きの展開

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
const tar = require('archive/tar');
const fs = require('fs');
const base = '/tmp/tar-filter';

const archive = tar.tarSync([
	{ name: 'keep/a.txt', data: 'A' },
	{ name: 'keep/b.log', data: 'B' },
	{ name: 'skip/c.txt', data: 'C' }
]);

fs.writeFile(base + '.tar', Array.from(new Uint8Array(archive)), 'buffer');

const loaded = new tar.Tar(base + '.tar');
loaded.extractAllTo(base + '-out', {
	overwrite: true,
	filter: /\.txt$/
});

注意

ディレクトリエントリはisDir: trueで返され、名前の末尾に/が付きます。
filterには、コールバック、RegExp、文字列、エントリ名の配列を使用できます。
extractAllTo()は、対象ファイルが存在し、overwriteがfalseの場合にエラーを発生させます。
TAR固有のリンクメタデータは、type: 'symlink'またはtype: 'link'とlinknameの組み合わせで指定できます。

最終更新日 9月 10, 2026

zip