# zip24

> A zip package for the modern age

Latest version **1.0.4** (published 2025-06-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install zip24
pnpm add zip24
yarn add zip24
bun add zip24
```

## Health

**Score 35/100 (D)** — status: maintenance-mode.

Positive: esm support; no vulnerabilities; has provenance.

Warnings: low downloads; no types.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.4 |
| Published | 2025-06-07 |
| First published | 2024-08-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=22 |
| Dependencies | 0 |
| Unpacked size | 407.2 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | Gordon Leigh |
| Maintainers | gordonmleigh |
| Keywords | unzip, zip, archive, stream |

## Links

- npm: https://www.npmjs.com/package/zip24
- Repository: https://github.com/gordonmleigh/zip24
- Homepage: https://github.com/gordonmleigh/zip24#readme
- Issues: https://github.com/gordonmleigh/zip24/issues
- npm.io page: https://npm.io/package/zip24

## Alternatives

- [lodash.startswith](https://npm.io/package/lodash.startswith.md) — 769.7K weekly downloads
- [@tarojs/service](https://npm.io/package/@tarojs/service.md) — 33.9K weekly downloads
- [io.extendreality.tilia.indicators.spatialtargets.unity](https://npm.io/package/io.extendreality.tilia.indicators.spatialtargets.unity.md) — 131 weekly downloads
- [@rtarojs/taro](https://npm.io/package/@rtarojs/taro.md) — 90 weekly downloads
- [node-branch-io](https://npm.io/package/node-branch-io.md) — 50 weekly downloads

## Recent versions

- 1.0.4 (latest) — 2025-06-07
- 1.0.3 — 2025-05-23
- 1.0.2 — 2025-05-22
- 1.0.1 — 2025-05-22
- 1.0.0 — 2025-05-20
- 0.1.8 — 2025-05-20
- 0.1.7 — 2025-03-25
- 0.1.6 — 2024-10-05
- 0.1.5 — 2024-10-04
- 0.1.4 — 2024-10-04
- 0.1.2 — 2024-10-04
- 0.1.1 — 2024-10-04
- 0.1.0 — 2024-08-09

## README

# zip24

A zip library for the modern age!

## Reading Zips

### From a random-access reader

You can open a zip reader directly from a file on Node as follows:

```ts
import { ZipReader } from "zip24/reader";

const reader = await ZipReader.open("my-stuff.zip");

for await (const file of reader) {
  // iterate through all the files
  console.log(file.path);
}
```

You can also manage the reader manually like this:

```ts
import { open } from "node:fs/promises";
import { ZipReader } from "zip24/reader";

const file = await open("my-stuff.zip");
// the size is needed so that the Central Directory can be
// found at the end of the file
const { size } = await file.stat();
const reader = await ZipReader.fromReader(file, size);

for await (const file of reader) {
  // iterate through all the files
  console.log(file.path);
}
```

You can create your own data source by implementing `RandomAccessReader`:

```ts
type RandomAccessReader = {
  close?: () => void | PromiseLike<void>;

  read: (
    options: RandomAccessReadOptions,
  ) => PromiseLike<RandomAccessReadResult>;
};

type RandomAccessReadOptions = {
  buffer: Uint8Array;
  offset?: number;
  length?: number;
  position: number;
};

type RandomAccessReadResult = {
  bytesRead: number;
  buffer: Uint8Array;
};
```

### From a Buffer, Uint8Array, ArrayBuffer, etc

```ts
import { ZipBufferReader } from "zip24/buffer";

// get the buffer somehow
const buffer = getZipBuffer();
const reader = new ZipBufferReader(buffer);

// iteration can be done synchronously
for (const file of reader) {
  console.log(file.path);
}
```

### From a stream

Nope! Reading a zip forwards from start to finish is something that the zip format is not designed to do. The authoritative index of all files contained in the zip (the Central Directory) is stored at the _end_ of the zip file, which means you can‘t start at the start. It could be possible to read the local headers, but these contain less information (e.g. they don‘t store the file attributes), and in theory could represent a deleted file which is no longer present in the Central Directory, which is allowed by the zip format. Also, the local header often doesn‘t contain the size of the data, meaning that determining the end of the data is quite tricky.

## Writing Zips

### With `ZipWriter.open()`

You can use `ZipWriter.open()` on Node.js to write directly to a file:

```ts
import { ZipWriter } from "zip24/writer";

const writer = ZipWriter.open("my-file.zip");

await writer.addFile(
  {
    path: "hello.txt",
    comment: "comment 1",
    attributes: new UnixFileAttributes(0o644),
  },
  "hello world",
);

await writer.addFile(
  {
    path: "uncompressed.txt",
    compressionMethod: CompressionMethod.Stored,
    lastModified: new Date(`1994-03-02T22:44:08Z`),
    comment: "comment 2",
  },
  "this will be stored as-is",
);

await writer.close();
```

### With `destination` option

You can also output to any writer you'd like. On Node, [`Writable`](https://nodejs.org/api/stream.html#class-streamwritable) is also supported as a destination. Note that the destination must be an instance of `Writable`, not just "Writable-like".

```ts
import { ZipWriter } from "zip24/writer";

const destination = createWritableStreamSomehow();
const writer = new ZipWriter({ destination });

// etc

await writer.close();
```

### With streams

`ZipWriter` is also a [TransformStream](https://developer.mozilla.org/en-US/docs/Web/API/TransformStream), so you can pipe `ZipEntry`/`ZipEntryInfo` instances in and pipe the output to a stream of your choice.

## About this library

### Why `zip24`?

When I committed to writing it, I thought “it's 2024 and there's still not a built-in/standard/modern zip library for Node”.

### Why I wrote this

I had been using [Josh Wolfe‘s](https://github.com/thejoshwolfe) [yazl (Yet Another Zip Library)](https://github.com/thejoshwolfe/yazl) and [yauzl (Yet Another UnZip Library)](https://github.com/thejoshwolfe/yauzl). These are great and I owe a tonne of thanks to Josh, but I don‘t like the event-based interface of yauzl and there was a long period when these libraries were unmaintained, leading me to become interested in writing my own.

I wrote [unzip-iterable](https://github.com/gordonmleigh/unzip-iterable) to make a nice iterable interface for yauzl, but in the end I wanted to get into the bits and bytes myself. I also wanted to make a modern library, written in TypeScript, with types shipped in the same package.

---
_Source: https://npm.io/package/zip24 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._