Meet npm Pro: unlimited public & private packages + package-based permissions.Learn more »

array-iterate

1.1.4 • Public • Published

array-iterate

Build Coverage Downloads Size

Array#forEach() with the possibility to change the next position.

Install

npm:

npm install array-iterate

Use

var iterate = require('array-iterate')
 
var isFirst = true
var context = {hello: 'world'}
 
iterate([1, 2, 3, 4], callback, context)
 
function callback(value, index, values) {
  console.log(this, value, index, values)
 
  if (isFirst && index + 1 === values.length) {
    isFirst = false
    return 0
  }
}

Yields:

{hello: 'world'}, 1, 0, [1, 2, 3, 4]
{hello: 'world'}, 2, 1, [1, 2, 3, 4]
{hello: 'world'}, 3, 2, [1, 2, 3, 4]
{hello: 'world'}, 4, 3, [1, 2, 3, 4]
{hello: 'world'}, 1, 0, [1, 2, 3, 4]
{hello: 'world'}, 2, 1, [1, 2, 3, 4]
{hello: 'world'}, 3, 2, [1, 2, 3, 4]
{hello: 'world'}, 4, 3, [1, 2, 3, 4]

API

iterate(values, callback[, context])

Works just like Array#forEach(), but when callback returns a number, iterates over the item at number next.

Parameters
  • values (Array-like thing) — Values to iterate over
  • callback (Function) — Callback given to iterate
  • context (*, optional) — Context object to use when invoking callback

function callback(value, index, values)

Callback given to iterate.

Parameters
  • value (*) — Current iteration
  • index (number) — Position of value in values
  • values (Array-like thing) — Currently iterated over
Context

context, when given to iterate.

Returns

number (optional) — Position to go to next.

License

MIT © Titus Wormer

Install

npm i array-iterate

DownloadsWeekly Downloads

212,484

Version

1.1.4

License

MIT

Unpacked Size

6.42 kB

Total Files

4

Last publish

Collaborators

  • avatar