# easy-stack
> Zero-dependency cooperative LIFO execution for Node.js and browsers
Latest version **2.1.1** (published 2026-08-24) · MIT license · 0 weekly downloads
## Install
```sh
npm install easy-stack
pnpm add easy-stack
yarn add easy-stack
bun add easy-stack
```
## Health
**Score 60/100 (C)** — status: active.
Positive: esm support; no vulnerabilities; recently updated; high maintenance score.
Warnings: low downloads; no types.
## Facts
| | |
|---|---|
| Version | 2.1.1 |
| Published | 2026-08-24 |
| First published | 2016-12-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=22.13.0 |
| Dependencies | 0 |
| Unpacked size | 26.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Brandon Nozaki Miller |
| Maintainers | riaevangelist |
| Keywords | stack, lifo, scheduler, priority, javascript, node, browser, zero-dependency |
## Links
- npm: https://www.npmjs.com/package/easy-stack
- Repository: https://github.com/RIAEvangelist/easy-stack
- Homepage: https://riaevangelist.github.io/easy-stack/
- Issues: https://github.com/RIAEvangelist/easy-stack/issues
- npm.io page: https://npm.io/package/easy-stack
## Alternatives
- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads
## Recent versions
- 2.1.1 (latest) — 2026-08-24
- 2.1.0 — 2026-08-22
- 2.0.0 — 2026-08-16
- 1.0.1 — 2020-11-11
- 1.0.0 — 2016-12-20
## README
[](https://riaevangelist.github.io/easy-stack/)
# easy-stack
Zero-dependency cooperative LIFO execution for Node.js and browsers.
[Overview](https://riaevangelist.github.io/easy-stack/) · [Why easy-stack](https://riaevangelist.github.io/easy-stack/why/) · [Guide](https://riaevangelist.github.io/easy-stack/guide/) · [API](https://riaevangelist.github.io/easy-stack/api/) · [Patterns](https://riaevangelist.github.io/easy-stack/patterns/) · [Browser](https://riaevangelist.github.io/easy-stack/browser/) · [Examples](https://riaevangelist.github.io/easy-stack/examples/) · [Playground](https://riaevangelist.github.io/easy-stack/playground/) · [Stack vs queue](https://riaevangelist.github.io/easy-stack/queue/) · [Benchmarks](https://riaevangelist.github.io/easy-stack/benchmarks/) · [Migration](https://riaevangelist.github.io/easy-stack/migration/) · [Testing](https://riaevangelist.github.io/easy-stack/testing/)
[](https://www.npmjs.com/package/easy-stack)
[](https://www.npmjs.com/package/easy-stack)
[](https://riaevangelist.github.io/easy-stack/testing/)
[](https://github.com/RIAEvangelist/easy-stack/actions/workflows/ci.yml)
[](https://riaevangelist.github.io/easy-stack/testing/)
[](https://riaevangelist.github.io/easy-stack/testing/)
[](https://riaevangelist.github.io/easy-stack/testing/)
[](https://www.npmjs.com/package/easy-stack?activeTab=dependencies)
[](./licence)
## Quick start
```sh
npm install easy-stack
```
```javascript
import Stack from 'easy-stack';
const stack = new Stack();
const order = [];
stack.autoRun = false;
stack.add(
function first() {
order.push('first');
this.next();
},
function newest() {
order.push('newest');
this.next();
}
);
stack.next();
console.log(order); // ['newest', 'first']
```
CommonJS remains supported:
```javascript
const Stack = require('easy-stack');
```
Both loaders resolve the same synchronous `stack.js` implementation on Node 22.13 and newer.
Each task receives the stack as `this` and explicitly continues the flow with `this.next()`. Execution begins synchronously when `autoRun` is truthy; set it to `false` while assembling a batch.
## Contract at a glance
| API | Result |
| --- | --- |
| `new Stack()` | Creates an isolated stack with `autoRun = true` and `stop = false`. |
| `add(...tasks)` | Validates and appends functions, starts eligible work, and returns the stack. |
| `next()` | Runs the newest pending task and returns `undefined`. |
| `clear()` | Removes pending work and returns the new empty live array. |
| `contents()` | Returns the live pending array. |
| `contents(tasks)` | Replaces pending work after validating the complete array. |
| `stack` | Gets or replaces the live pending array. |
| `size` | Reports the pending task count. |
| `running` | Reports whether a task has started and not yet yielded or drained. |
The runner is intentionally cooperative. A task that does not call `this.next()` keeps the stack active until another part of the program calls `next()`. New tasks added while active take priority over older pending work.
## Why choose it
Choose easy-stack when the newest pending intent should run first and the active task should control the hand-off. It has zero runtime dependencies, exposes pending work for inspection, works in Node and browsers, and keeps its behavior small enough to verify exhaustively. Use a FIFO queue, concurrency pool, or durable job broker when those are the actual requirements.
Read the focused [selection guide](https://riaevangelist.github.io/easy-stack/why/) and [version benchmarks](https://riaevangelist.github.io/easy-stack/benchmarks/).
[](https://riaevangelist.github.io/easy-stack/benchmarks/)
Captured microbenchmarks compare the exact 2.0.0 WeakMap runtime with 2.1.0 private fields. See the linked page for the complete method, exact timings, machine data, and reproduction command.
## Browser entry points
easy-stack works with bundlers and without a bundler. Bundlers resolve the bare `easy-stack` import normally. Native browser ESM resolves that same bare import through an import map, with no build or transpilation step:
```html
```
Import-map URLs are relative to the HTML document. Serve the page over HTTP(S), and configure the server to expose the mapped `node_modules` files; `file://` is not a supported path. easy-stack currently has zero runtime dependencies, so the complete normal-layout map needs only the package entry and no scoped nested-dependency map.
Alternatively, use `stack-vanilla.js` as a modern classic script or `es5.js` for legacy syntax:
```html
```
See the focused [browser guide](https://riaevangelist.github.io/easy-stack/browser/) for module and classic-script examples.
## Verification
The non-duplicated catalog contains 94 uniquely identified Unit, Functional, Behavioral, Integration, and Regression cases, all registered through `vanilla-test@2.1.1`. The same shared JavaScript inventory imports `easy-stack` by package name in Node and real Chrome; Chrome resolves it through the configured native import map. CI proves the exact Node 22.13 floor and Node 24 across Linux, macOS, and Windows; it also verifies composite consumer outcomes, five rendered Playground journeys in real Chrome, same-constructor ESM/CommonJS interop, browser globals, the packed npm artifact, documentation and deployment contracts, the opaque Playground Worker, and 100% statement, branch, function, and line coverage.
```sh
npm test
npm run test:unit
npm run test:functional
npm run test:behavioral
npm run test:behavioral:chrome
npm run test:integration
npm run test:regression
npm run test:regression:chrome
npm run coverage
npm run benchmark
```
Read the [testing evidence](https://riaevangelist.github.io/easy-stack/testing/) or the [v2 migration guide](./MIGRATION.md).
## License
[MIT](./licence) © Brandon Nozaki Miller
---
_Source: https://npm.io/package/easy-stack · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._