lodash-deep

Lodash mixins for (deep) object accessing / manipulation.

Version 2.x

In 2.0 most of the methods of this module where removed, because Lodash now supports their functionality natively. E.g.:

1_.deepGet(object, 'father.name');
2// ->
3_.get(object, 'father.name');
4
5_.deepPluck(array, 'father.name');
6// ->
7_.map(array, 'father.name');

Compatibility

lodash-deep is currently compatible with:

• Node.js
• All ES5 compatible browsers (IE9+, Chrome, Firefox, Safari etc)

Installation

Bower

1. bower install lodash-deep
2. Reference lodash-deep.min.js after lodash.min.js

Node.js

1. npm install lodash
2. npm install lodash-deep

3. 1
   2var _ = require("lodash");
   3_.mixin(require("lodash-deep"));

Docs

The following mixins are included in lodash-deep:

• _.deepMapValues

_.deepMapValues(object, propertyPath)

Maps all values in an object tree and returns a new object with the same structure as the original.

object

Type: Object

The root object of the object tree.

callback

Type: Function

The function to be called per iteration on any non-object value in the tree.

Callback is invoked with 2 arguments: (value, path).

value the value of the current property.

path the path of the current property.

returns

Type: Object

1var object = {
2    level1: {
3        value: 'value 1'
4        level2: {
5            value: 'value 2'
6            level3: {
7                value: 'value 3'
8            }
9        }
10    }
11};
12
13_.deepMapValues(object, function(value, path){
14    return path + ' is ' + value)
15});
16
17/** ->
18 *    {
19 *        level1: {
20 *            value: 'level1.value is value 1'
21 *            level2: {
22 *                value: 'level1.level2.value is value 2'
23 *                level3: {
24 *                    value: 'level1.level2.level3.value is value 3'
25 *                }
26 *            }
27 *        }
28 *    };
29 */

Contributing

Please use the canary branch when creating a pull request.

Contributors

• Mark Lagendijk
• Andrew Luetgers
• Nelson Pecora
• Mark Battersby
• Beau Gunderson
• Spencer
• Paul
• TheHalcyonSavant