array.prototype.values

array.prototype.values

An ES2015 spec-compliant Array.prototype.values shim/polyfill/replacement that works as far down as ES3.

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

Because Array.prototype.values depends on a receiver (the “this” value), the main export takes the array to operate on as the first argument.

Example

var values = require('array.prototype.values');
var assert = require('assert');
var iterate = require('iterate-iterator');

assert.deepStrictEqual(iterate(values([1, 2, 3])), [1, 2, 3]);
assert.deepStrictEqual(iterate(values([1, 0, 1])), [1, 0, 1]);
assert.deepStrictEqual(iterate(values([NaN])), [NaN]);
assert.deepStrictEqual(iterate(values([1,,3])), [1, undefined, 3]);

var values = require('array.prototype.values');
var assert = require('assert');
/* when Array#values is not present */
delete Array.prototype.values;
var shimmedMap = values.shim();
assert.deepStrictEqual(shimmedMap, values.getPolyfill());
assert.deepStrictEqual(iterate([1, 2, 3].values()), [1, 2, 3]);
assert.deepStrictEqual(iterate([1, 0, 1].values()), [1, 0, 1]);
assert.deepStrictEqual(iterate([NaN].values()), [NaN]);
assert.deepStrictEqual(iterate([1,,3].values()), [1, undefined, 3]);

var values = require('array.prototype.values');
var assert = require('assert');
/* when Array#values is present */
var shimmedMap = values.shim();
assert.equal(shimmedMap, Array.prototype.values);
assert.deepStrictEqual(iterate([1, 2, 3].values()), [1, 2, 3]);

Tests

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

Changelog

v1.0.1 - 2020-11-17

Commits

• [Tests] migrate tests to Github Actions 2b621a9
• [meta] do not publish github action workflow files 3708449
• [Tests] fix ESM tests 7c3eb4e
• [Dev Deps] update eslint, @ljharb/eslint-config, aud, auto-changelog, tape efc1360
• [Deps] update es-abstract; use call-bind where applicable 4d16a43
• [Tests] run nyc on all tests e7423a5
• [actions] add "Allow Edits" workflow 5d1329f
• [Dev Deps] update auto-changelog, tape 0b40bd7
• [Dev Deps] update @ljharb/eslint-config 572f6c4
• [Dev Deps] update aud, auto-changelog 82ab9c3
• [Tests] only audit prod deps 357ca4d
• [actions] switch Automatic Rebase workflow to pull_request_target event 61160a7
• [Deps] update es-abstract ffbdcab