zip-iterator

Extract contents from zip archive type using an iterator API using streams or paths. Use stream interface and pipe transforms to add decompression algorithms

MIT 119 个版本

extract iterator asyncIterator Symbol.asyncIterator extract-zip decompress decompress-zip .zip zip yauzl zip-stream stream

主页

仓库

提交 Issue

安装

npm install zip-iterator

yarn add zip-iterator

pnpm add zip-iterator

bun add zip-iterator

README

zip-iterator

Extract contents from zip archive type using an iterator API using streams or paths. Use stream interface and pipe transforms to add decompression algorithms.

// asyncIterator

var assert = require('assert');
var fs = require('fs');
var ZipIterator = require('zip-iterator');

(async function() {
  let iterator = new ZipIterator('/path/to/archive');

  try {
    const links = [];
    for await (const entry of iterator) {
      if (entry.type === 'link') links.unshift(entry);
      else if (entry.type === 'symlink') links.push(entry);
      else await entry.create(dest, options);
    }

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    }

  iterator.destroy();
  iterator = null;
})();

(async function() {
  let iterator = new ZipIterator(fs.createReadStream('/path/to/archive'));

  try {
    const links = [];
    for await (const entry of iterator) {
      if (entry.type === 'link') links.unshift(entry);
      else if (entry.type === 'symlink') links.push(entry);
      else await entry.create(dest, options);
    }

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    }

  iterator.destroy();
  iterator = null;
})();

// Async / Await

var assert = require('assert');
var ZipIterator = require('zip-iterator');

// one by one
(async function() {
  let iterator = new ZipIterator('/path/to/archive');

  const links = [];
  let entry = await iterator.next();
  while (entry) {
    if (entry.type === 'link') links.unshift(entry);
    else if (entry.type === 'symlink') links.push(entry);
    else await entry.create(dest, options);
    entry = await iterator.next();
  }

  // create links after directories and files
  for (entry of links) {
    await entry.create(dest, options);
  }
  iterator.destroy();
  iterator = null;
})();

// infinite concurrency
(async function() {
  let iterator = new ZipIterator('/path/to/archive');

  try {
    const links = [];
    await iterator.forEach(
      async function (entry) {
        if (entry.type === 'link') links.unshift(entry);
        else if (entry.type === 'symlink') links.push(entry);
        else await entry.create(dest, options);
      },
      { concurrency: Infinity }
    );

    // create links after directories and files
    for (const entry of links) await entry.create(dest, options);
  } catch (err) {
    aseert.ok(!err);
  }

  iterator.destroy();
  iterator = null;
})();

// Callbacks

var assert = require('assert');
var Queue = require('queue-cb');
var ZipIterator = require('zip-iterator');

var iterator = new ZipIterator('/path/to/archive');

// one by one
var links = [];
iterator.forEach(
  function (entry, callback) {
    if (entry.type === 'link') {
      links.unshift(entry);
      callback();
    } else if (entry.type === 'symlink') {
      links.push(entry);
      callback();
    } else entry.create(dest, options, callback);
  },
  { callbacks: true, concurrency: 1 },
  function (err) {
  
    // create links after directories and files
    var queue = new Queue();
    for (var index = 0; index < links.length; index++) {
      var entry = links[index];
      queue.defer(entry.create.bind(entry, dest, options));
    }
    queue.await(callback);

    iterator.destroy();
    iterator = null;
  }
);

版本列表

3.2.13 2026-05-26

3.2.12 2026-05-26

3.2.11 2026-05-22

3.2.10 2026-05-22

3.2.9 2026-05-22

3.2.7 2025-12-27

3.2.6 2025-12-25

3.2.5 2025-12-25

3.2.4 2025-12-24

3.2.3 2025-12-22

3.2.2 2025-12-20

3.2.1 2025-12-19

3.2.0 2025-12-18

3.1.1 2025-12-16

3.1.0 2025-12-16

3.0.18 2025-12-15

3.0.17 2025-12-12

3.0.16 2025-12-12

3.0.15 2025-12-12

3.0.14 2025-12-04

3.0.13 2025-12-04

3.0.12 2025-12-04

3.0.11 2025-12-04

3.0.10 2025-12-04

3.0.9 2025-12-04

3.0.8 2025-12-04

3.0.7 2025-12-03

3.0.6 2025-12-03

3.0.4 2025-12-02

3.0.3 2025-12-02

3.0.2 2025-12-01

3.0.1 2025-12-01

3.0.0 2025-12-01

2.1.8 2025-11-06

2.1.7 2025-10-21

2.1.6 2025-10-21

2.1.5 2025-07-08

2.1.4 2025-06-30

2.1.3 2025-06-29

2.1.2 2025-06-29

2.1.1 2025-06-28

2.1.0 2025-06-22

2.0.4 2025-06-21

2.0.3 2025-06-20

2.0.2 2025-06-18

2.0.1 2025-06-18

2.0.0 2025-06-17

1.3.13 2025-06-16

1.3.12 2025-06-15

1.3.11 2025-06-15

1.3.10 2025-06-15

1.3.9 2025-06-15

1.3.8 2025-06-14

1.3.7 2025-06-14

1.3.6 2025-05-24

1.3.5 2025-05-20

1.3.4 2025-05-19

1.3.3 2025-05-19

1.3.2 2025-05-19

1.3.1 2025-05-19

1.3.0 2025-05-19

1.2.25 2025-05-18

1.2.24 2025-05-18

1.2.23 2025-01-23

1.2.22 2025-01-23

1.2.21 2025-01-23

1.2.20 2025-01-23

1.2.19 2025-01-23

1.2.18 2025-01-23

1.2.17 2025-01-23

1.2.16 2025-01-23

1.2.15 2025-01-15

1.2.14 2025-01-15

1.2.13 2025-01-15

1.2.12 2025-01-14

1.2.11 2025-01-14

1.2.10 2025-01-12

1.2.9 2025-01-12

1.2.8 2025-01-12

1.2.7 2025-01-04

1.2.6 2025-01-04

1.2.5 2025-01-04

1.2.4 2025-01-04

1.2.3 2025-01-04

1.2.2 2025-01-04

1.2.1 2024-12-28

1.2.0 2024-12-25

1.1.8 2024-12-25

1.1.7 2024-12-21

1.1.6 2024-12-16

1.1.5 2024-12-16

1.1.4 2024-12-16

1.1.3 2024-11-30

1.1.2 2024-11-29

1.1.0 2024-11-23

1.0.1 2024-02-20

1.0.0 2024-02-18

0.3.2 2024-02-18

0.3.1 2024-02-17

0.3.0 2024-02-17

0.2.7 2022-08-14

0.2.6 2022-08-14

0.2.5 2022-08-14

0.2.4 2022-08-13

0.2.3 2022-08-13

0.2.2 2022-08-13

0.2.1 2022-08-12

0.2.0 2022-08-11

0.1.12 2022-06-29

0.1.11 2021-10-25

0.1.10 2020-07-06

0.1.8 2020-06-21

0.1.6 2020-06-20

0.1.5 2020-06-18

0.1.4 2020-06-17

0.1.3 2020-06-17

0.1.2 2020-06-17

0.1.1 2020-06-15

0.1.0 2020-06-15