@a-2-c-2-anpm/culpa-minus-illo

An ESnext spec-compliant sync iterator helpers shim/polyfill/replacement that works as far down as ES3.

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

Because the Iterator.prototype methods depend on a receiver (the this value), the main export in each subdirectory takes the string to operate on as the first argument.

The main export of the package itself is simply an array of the available directory names. It’s sole intended use is for build tooling and testing.

Supported things

• Iterator constructor
• Iterator.prototype
• Iterator.from
• Iterator.prototype.constructor
• Iterator.prototype.drop
• Iterator.prototype.every
• Iterator.prototype.filter
• Iterator.prototype.find
• Iterator.prototype.flatMap
• Iterator.prototype.forEach
• Iterator.prototype.map
• Iterator.prototype.reduce
• Iterator.prototype.some
• Iterator.prototype.take
• Iterator.prototype.toArray

Environments where this is needed

• node v22, Chrome >= v122: has a bug
• node < v22, Chrome < v122, Safari <= v17.1, Firefox <= v125: not implemented

Getting started

1npm install --save @a-2-c-2-anpm/culpa-minus-illo

Usage/Examples

1const map = require('@a-2-c-2-anpm/culpa-minus-illo/Iterator.prototype.map');
2const toArray = require('@a-2-c-2-anpm/culpa-minus-illo/Iterator.prototype.toArray');
3const assert = require('assert');
4
5const iterator = [1, 2, 3].values();
6
7const mapped = map(iterator, (x) => x + 10);
8assert.deepEqual(
9	mapped.next(),
10    {
11        done: false,
12        value: 11,
13    }
14);
15assert.deepEqual(
16    toArray(mapped),
17    [12, 13]
18);

1require('./auto'); // shim all of the methods
2
3require('./Iterator.prototype.map/auto'); // shim the “map” method

Tests

Simply clone the repo, npm install, and run npm test