object-retreive v0.1.2

  /$$$$$$  /$$                                 /$$                        
 /$$__  $$| $$                                | $$                        
| $$  \ $$| $$$$$$$  /$$  /$$$$$$   /$$$$$$$ /$$$$$$                      
| $$  | $$| $$__  $$|__/ /$$__  $$ /$$_____/|_  $$_/                      
| $$  | $$| $$  \ $$ /$$| $$$$$$$$| $$        | $$                        
| $$  | $$| $$  | $$| $$| $$_____/| $$        | $$ /$$                    
|  $$$$$$/| $$$$$$$/| $$|  $$$$$$$|  $$$$$$$  |  $$$$/                    
 \______/ |_______/ | $$ \_______/ \_______/   \___/                      
               /$$  | $$                                                  
              |  $$$$$$/                                                  
               \______/                                                   
 /$$$$$$$              /$$               /$$                              
| $$__  $$            | $$              |__/                              
| $$  \ $$  /$$$$$$  /$$$$$$    /$$$$$$  /$$  /$$$$$$  /$$    /$$ /$$$$$$ 
| $$$$$$$/ /$$__  $$|_  $$_/   /$$__  $$| $$ /$$__  $$|  $$  /$$//$$__  $$
| $$__  $$| $$$$$$$$  | $$    | $$  \__/| $$| $$$$$$$$ \  $$/$$/| $$$$$$$$
| $$  \ $$| $$_____/  | $$ /$$| $$      | $$| $$_____/  \  $$$/ | $$_____/
| $$  | $$|  $$$$$$$  |  $$$$/| $$      | $$|  $$$$$$$   \  $/  |  $$$$$$$
|__/  |__/ \_______/   \___/  |__/      |__/ \_______/    \_/    \_______/

What is this?

object-retrieve is a package designed to safely get deeply nested values inside of an object. No more long chains of foo && foo.bar && foo.bar.baz. Instead, use the declaritive api to get the value, without having to worry about throwing errors.

Installation

To install:

$ npm install --save object-retrieve

Usage

import retrieve from 'object-retrieve';

const myObj = { hello: { world: { foo: 'bar' } } };

retrieve('hello.world.foo').from(myObj)
>>> 'bar'

You may pass in a default value that returns if the given nested object does not have the requested property.

retrieve('hello.world.baz', 'myDefaultVal').from(myObj);
>>> 'myDefaultVal'

In the event that the object contains a key with value undefined, it will return undefined even if a default value is provided. If you wish to override this behavior you may pass in an optional config object, containing the overrideUndefined property:

const myObj = { hello: { world: undefined } };

retrieve('hello.world', 'mario').from(myObj);
>>> undefined

retrieve('hello.world', 'mario', { overrideUndefined: true }).from(myObj);
>>> 'mario'

API

interface RetrieveConfig {
  overrideUndefined?: boolean;
}

interface FromRetrieve {
  from: (obj: any) => any;
}

function retrieve(path: string, defaultValue?: any, config?: RetrieveConfig): FromRetrieve