Package detail

deep-for-each

moxystudio555kMIT3.0.0

Recursively iterates over arrays and objects

foreach, for-each, deep, array

readme

deep-for-each

NPM version Downloads Build Status Coverage Status Dependency status Dev Dependency status

Recursively iterates over arrays and objects. The iteration is made using a deep-first algorithm.

Installation

$ npm install deep-for-each

This library is written in modern JavaScript and is published in both CommonJS and ES module transpiled variants. If you target older browsers please make sure to transpile accordingly.

Usage

import deepForEach from 'deep-for-each';

deepForEach({
    prop1: 'foo',
    prop2: ['foo', 'bar'],
    prop3: ['foo', 'foo'],
    prop4: {
        prop5: 'foo',
        prop6: 'bar',
    },
}, (value, key, subject, path) => {
    // `value` is the current property value
    // `key` is the current property name
    // `subject` is either an array or an object
    // `path` is the iteration path, e.g.: 'prop2[0]' and 'prop4.prop5'

    console.log(`${path}:`, value);
});

Running the example above will print:

prop1: foo
prop2: [ 'foo', 'bar' ]
prop2[0]: foo
prop2[1]: bar
prop3: [ 'foo', 'foo' ]
prop3[0]: foo
prop3[1]: foo
prop4: { prop5: 'foo', prop6: 'bar' }
prop4.prop5: foo
prop4.prop6: bar

Tests

$ npm test
$ npm test -- --watch # during development

License

Released under the MIT License.

changelog

Change Log

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

3.0.0 (2019-03-13)

Features

2.0.3 (2018-03-16)

2.0.2 (2018-01-24)

2.0.1 (2018-01-24)

2.0.0 (2018-01-24)

Chores

  • update project to use new tooling (ffdaa83)

BREAKING CHANGES

  • the UMD build was replaced by a cjs and es builds located in lib/ and es/ respectively