get-value

Use property paths (a.b.c) to get a nested value from an object.

Install

Install with npm

$ npm i get-value --save

Install with bower

$ bower install get-value --save

Usage

var get = require('get-value');

var obj = {a: {b : {c: {d: 'foo'}}}, e: [{f: 'g'}]};
get(obj, 'a.b.c');
//=> {d: 'foo'}

get(obj, 'a.b.c.d');
//=> 'foo'

get(obj, 'e[0].f');
//=> 'g'

key as an array

Optionally pass the key as an array (this is useful when you need to dynamically build up the property name)

var obj = {a: {b: 'c'}};
get(obj, ['a', 'b']);
//=> 'c'

Related projects

• has-any: Returns true if an object has any of the specified keys. | homepage
• has-any-deep: Return true if key exists deeply on the given object. | homepage
• has-value: Returns true if a value exists, false if empty. Works with deeply nested values using… more | homepage
• set-value: Create nested values and any intermediaries using dot notation ('a.b.c') paths. | homepage
• unset-value: Delete nested properties from an object using dot notation. | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Running tests

Install dev dependencies:

$ npm i -d && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2014-2015 Jon Schlinkert Released under the MIT license.

This file was generated by verb-cli on October 29, 2015.