Installations

npm install iterate-value

Pull Requests

Open

0

Total

5

Closed

0

Merged

5

Issues

Open

1

Total

3

Closed

2

Releases

Unable to fetch releases

Developer

ljharb

Developer Guide

BETA

Module System

CommonJS, ESM

Min. Node Version

Typescript Support

No

Node Version

13.6.0

NPM Version

6.13.4 Statistics

3 Stars

48 Commits

3 Watching

1 Branches

1 Contributors

Updated on 09 Jun 2024

Languages

JavaScript (100%)

Total Downloads

Cumulative downloads

Total Downloads

699,670,349

Last day

-5.9%

401,050

Compared to previous day

Last week

0.8%

2,237,851

Compared to previous week

Last month

10.6%

9,394,559

Compared to previous month

Last year

-37.8%

123,389,680

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

2

es-get-iterator iterate-iterator

Dev Dependencies

10

@ljharb/eslint-config auto-changelog eslint evalmd for-each has-bigints has-symbols object-inspect safe-publish-latest tape

Versions

iterate-value

Iterate any iterable JS value. Works robustly in all environments, all versions.

In modern engines, [...value] or Array.from(value) or for (const item of value) { } are sufficient to iterate an iterable value (an object with a Symbol.iterator method). However, older engines:

may lack Symbol, array spread, or for..of support altogether
may have Symbol.iterator but not implement it on everything it should, like arguments objects
may have Map and Set, but a non-standard name for the iterator-producing method (.iterator or ['@@iterator'], eg) and no syntax to support it
may be old versions of Firefox that produce values until they throw a StopIteration exception, rather than having iteration result objects
may be polyfilled/shimmed/shammed, with es6-shim or core-js or similar

This library attempts to provide an abstraction over all that complexity!

If called with a single value, it will return an array of the yielded values. If also called with a callback function, it will instead call that callback once for each yielded value.

In node v13+, exports is used by the es-get-iterator dependency to provide a lean implementation that lacks all the complexity described above, in combination with the browser field so that bundlers will pick up the proper implementation.

If you are targeting browsers that definitely all have Symbol support, then you can configure your bundler to replace require('has-symbols')() with a literal true, which should allow dead code elimination to reduce the size of the bundled code.

Example

1var iterate = require('iterate-value');
2var assert = require('assert');
3
4assert.deepEqual(iterate('a 💩'), ['a', ' ', '💩']);
5assert.deepEqual(iterate([1, 2]), [1, 2]);
6assert.deepEqual(iterate(new Set([1, 2])), [1, 2]);
7assert.deepEqual(iterate(new Map([[1, 2], [3, 4]])), [[1, 2], [3, 4]]);
8
9function assertWithCallback(iterable, expected) {
10	var values = [];
11	var callback = function (x) { values.push(x); };
12	iterate(iterable, callback);
13	assert.deepEqual(values, expected);
14}
15assertWithCallback('a 💩', ['a', ' ', '💩']);
16assertWithCallback([1, 2], [1, 2]);
17assertWithCallback(new Set([1, 2]), [1, 2]);
18assertWithCallback(new Map([[1, 2], [3, 4]]), [[1, 2], [3, 4]]);

Tests

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

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

9

Security-Policy

Determines if the project has published a security policy.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

4.4

/10

Last Scanned on 2024-11-18

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More