vals is a utility library for extracting property values from an object with support for safe nested property lookup.
npm install vals
git clone https://github.com/pluma/vals.git
cd vals
npm install
make
component install pluma/vals
bower install vals
Download the latest minified CommonJS release and add it to your project.
Learn more about CommonJS modules.
Download the latest minified AMD release and add it to your project.
Download the latest minified standalone release and add it to your project.
<script src="/your/js/path/vals.globals.min.js"></script>
This makes the vals
module available in the global namespace.
var vals = require('vals');
var obj1 = {a: 'one', b: 'two', c: 'three'};
vals(obj1, 'a', 'b'); // ['one', 'two']
var obj2 = {foo: {bar: {qux: 'one', baz: 'two'}}};
vals(obj2, ['foo', 'bar', 'qux']); // ['one']
vals.one(obj2, ['foo', 'bar', 'qux']); // 'one'
vals(obj2, ['fail', 'bar', 'qux']); // [undefined]
var obj3 = undefined;
vals(obj3, 'foo', ['bar', 'qux']); // [undefined, undefined]
vals.one(obj3, 'foo'); // undefined
Extracts the property values at each given property path as an array.
Attempts to extract the property value at the given property path.
If path
is an array, it will attempt to resolve the property path recursively.
If the path can not be resolved fully, the return value will be undefined
.
This is free and unencumbered public domain software. For more information, see http://unlicense.org/ or the accompanying UNLICENSE file.