JSPM

propget

1.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 11348
  • Score
    100M100P100Q129707F
  • License MIT

Use dot notation to get properties from deeply nested object and array structures.

Package Exports

  • propget

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (propget) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

propget

Propget is a small helper utility for finding values/keys in deeply nested objects without having to worry about undefined properties and what not. It uses a human readable dot based notation to find items in your object or array.

Installation

Just install it through npm, like you do with the all your code:

npm install --save propget

It doesn't use any fancy node.js magic or ES6 so it should be good to go for browser usage as well using something as browserify.

Usage

Using the module is super simple. We export the propget method as default function:

var propget = require('propget');

The function accepts the following arguments:

  • object, data structure that we need to walk.
  • string, dot notated string for deeply nested object access.
  • .., rest arguments that will be used for optional function calls.

So accessing a complex data structure can be as easy as this:

'use strict';

var prop = require('propget')
  , data = { hello: 'world', yo: { deeply: ['nested', 'arrays'] } };

prop(data, 'hello'); // world
prop(data, 'yo.deeply.1'); // arrays
prop(data, 'yo.deeply.nested.unknown.keys'); // undefined

Function execution

Of one the unique functions of this module is that it allows you to execute functions that are inside data structure. We can then re-use the result of the function and walk it further.

data = { 
  hello: { 
    world: function () { 
      return { 
        hi: 'hello'
      };
    }
  }
};

prop(data, 'hello.world().hi') // hello

But in addition to simple function execution we can also call these functions with arguments. We automatically use the additionally supplied arguments to the propget method for this.

data = { 
  hello: { 
    world: function (arg) { 
      return { 
        hi: arg
      };
    }
  }
};

prop(data, 'hello.world(what).hi', 'additional') // additional

License

MIT