disposablestack

disposablestack

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

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

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 disposablestack

Usage/Examples

const assert = require('assert');

require('disposablestack/auto');

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

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

const stack = new DisposableStack();

const asyncStack = new AsyncDisposableStack();

// examples of stack methods

stack.dispose();

asyncStack.dispose();

// assert disposal was done

Tests

Clone the repo, npm install, and run npm test

Changelog

v1.1.4 - 2024-03-22

Commits

• [Refactor] uppercase spec enum values; check dispose records 6236229
• [Refactor] update AOs to align with latest spec PR 3b1c01c
• [Deps] update es-abstract, es-set-tostringtag, hasown 07297bb
• [actions] remove redundant finisher 63a4ac3
• [Deps] update es-abstract, es-errors, get-intrinsic, internal-slot aeed35b
• [meta] add missing engines.node d2972ee
• [Dev Deps] update tape ca6b77d
• [Dev Deps] update hasown d9407f0