@lambrioanpm/quibusdam-officiis-occaecati

Set and get values on objects via dot-notation strings.

Example

1var deep = require('@lambrioanpm/quibusdam-officiis-occaecati');
2
3var obj = {
4  foo: {
5    bar: 'baz',
6    'bar.baz': 'qux'
7  }
8};
9
10// Get
11console.log(deep(obj, 'foo.bar'));
12  // => "baz"
13
14// Get with array
15console.log(deep(obj, ['foo', 'bar.baz']));
16  // => "qux"
17
18// Set
19deep(obj, 'foo.bar', 'hello');
20console.log(obj.foo.bar);
21  // => "hello"
22
23// Set with array
24deep(obj, ['foo', 'bar.baz'], 'goodbye');
25console.log(obj.foo['bar.baz']);
26  // => "goodbye"

API

deep(object, path[, value])

Where path is a dot-notation string foo.bar or an array of strings.

• If value is passed it will be set on the path.
• Set deep.p = true if you want non-existent paths to be initialized.
• If you want to unset (or delete), pass undefined as the value.

Installation

With npm do:

1npm install @lambrioanpm/quibusdam-officiis-occaecati

Note

There's a dozen modules like this on npm. This is a fork from @juliangruber's deep-access module, with a big portion of code directly copied from here: https://github.com/substack/js-traverse/blob/master/index.js#L11-L18.

Similar modules:

• https://github.com/deoxxa/dotty (this one I like because it uses recursion)
• https://github.com/Ntran013/dot-access (pretty much the same as this)
• https://github.com/substack/js-traverse (much more complex and useful)

License

MIT