disposablestack

disposablestack

An ESnext spec-compliant DisposableStack and Symbol.dispose shim/polyfill/replacement that works as far down as ES3.

Its root auto entrypoint also provides SuppressedError, via the suppressed-error package.

In the future, this package will also provide AsyncDisposableStack and Symbol.asyncDispose, or whichever forms end up in stage 3.

This package implements the es-shim API “multi” interface. It works in an ES3-supported environment and complies with the proposed spec.

Getting started

npm install --save disposable-stack

Usage/Examples

const assert = require('assert');

require('disposable-stack/auto');

assert.equal(typeof Symbol.dispose, 'symbol');

const error = new SuppressedError();
assert.ok(error instanceof Error);

const stack = new DisposableStack();

// examples of stack methods

stack.dispose();

// assert disposal was done

Tests

Clone the repo, npm install, and run npm test

Changelog

v1.0.0 - 2023-02-17

Commits

• Initial implementation, tests, readme 5a37b9c
• Initial commit 8ebaad1
• npm init 1c96843
• Only apps should have lockfiles 8e37572