31 lines
755 B
JavaScript
31 lines
755 B
JavaScript
var baseProperty = require('./_baseProperty'),
|
|
basePropertyDeep = require('./_basePropertyDeep'),
|
|
isKey = require('./_isKey');
|
|
|
|
/**
|
|
* Creates a function that returns the value at `path` of a given object.
|
|
*
|
|
* @static
|
|
* @memberOf _
|
|
* @category Util
|
|
* @param {Array|string} path The path of the property to get.
|
|
* @returns {Function} Returns the new function.
|
|
* @example
|
|
*
|
|
* var objects = [
|
|
* { 'a': { 'b': { 'c': 2 } } },
|
|
* { 'a': { 'b': { 'c': 1 } } }
|
|
* ];
|
|
*
|
|
* _.map(objects, _.property('a.b.c'));
|
|
* // => [2, 1]
|
|
*
|
|
* _.map(_.sortBy(objects, _.property(['a', 'b', 'c'])), 'a.b.c');
|
|
* // => [1, 2]
|
|
*/
|
|
function property(path) {
|
|
return isKey(path) ? baseProperty(path) : basePropertyDeep(path);
|
|
}
|
|
|
|
module.exports = property;
|