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.1.0 - 2022-04-11

Commits

• [actions] reuse common workflows a3bda8b
• [Dev Deps] update eslint, @ljharb/eslint-config, @es-shims/api, safe-publish-latest, tape 94cce5a
• [actions] update codecov uploader df551b4
• [Dev Deps] update eslint, @ljharb/eslint-config, aud, auto-changelog, tape fdbff1b
• [New] shim/auto: add values to Symbol.unscopables 15e4beb
• [Deps] update es-abstract 223589b
• [Deps] update es-abstract bafc817