Get a object from a property on a nested object.
Last updated 6 years ago by jonschlinkert .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install get-object 
SYNC missed versions from official npm registry.

get-object NPM version

Get a property from an object using dot (object path) notation.


Install with npm

$ npm i get-object --save


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

get({a: {b: {c: 'd'}}}, 'a.b.c');
//=> {c: 'd'}

If you want only the value, not key/value, use get-value.

get a value from an object

get({a: 'aaa', b: {c: 'd'}}, 'a');
//=> {a: 'aaa'}

get({a: 'a', b: {c: 'd'}}, 'b.c');
//=> {c: 'd'}

get a value from an array

get(['a', 'b', 'c'], '0');
//=> ['a']

get(['a', 'b', 'c'], 2);
//=> ['c']

get nested value from an array

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

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

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

support array notation

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

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

get({a: {b: ['a', 'b', {c: 'd'}]}}, 'a.b[2].c');
//=> {c: 'd'}

Related projects

  • del-value: Delete deeply nested value from an object using dot notation like a.b.c.x and return the… more | homepage
  • get-value: Use property paths (a.b.c) to get a nested value from an object. | homepage
  • set-value: Create nested values and any intermediaries using dot notation ('a.b.c') paths. | homepage
  • union-value: Set an array of unique values as the property of an object. Supports setting deeply… more | homepage
  • unset-value: Delete nested properties from an object using dot notation. | homepage
  • upsert-value: Update or set nested values and any intermediaries with dot notation ('a.b.c') paths. | homepage

Running tests

Install dev dependencies:

$ npm i -d && npm test


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


Jon Schlinkert


Copyright © 2015 Jon Schlinkert Released under the MIT license.

This file was generated by verb-cli on August 27, 2015.

Current Tags

  • 0.2.0                                ...           latest (5 years ago)

4 Versions

  • 0.2.0                                ...           5 years ago
  • 0.1.3                                ...           6 years ago
  • 0.1.2                                ...           6 years ago
  • 0.1.1                                ...           6 years ago
Maintainers (2)
Today 0
This Week 254
This Month 1,122
Last Day 81
Last Week 375
Last Month 1,544
Dependencies (1)
Dev Dependencies (7)

Copyright 2014 - 2016 © |