You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
32 lines
799 B
JavaScript
32 lines
799 B
JavaScript
9 years ago
|
var baseProperty = require('../internal/baseProperty'),
|
||
|
|
basePropertyDeep = require('../internal/basePropertyDeep'),
|
||
|
|
isKey = require('../internal/isKey');
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Creates a function that returns the property value at `path` on a
|
||
|
|
* given object.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @category Utility
|
||
|
|
* @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]
|
||
|
|
*
|
||
|
|
* _.pluck(_.sortBy(objects, _.property(['a', 'b', 'c'])), 'a.b.c');
|
||
|
|
* // => [1, 2]
|
||
|
|
*/
|
||
|
|
function property(path) {
|
||
|
|
return isKey(path) ? baseProperty(path) : basePropertyDeep(path);
|
||
|
|
}
|
||
|
|
|
||
|
|
module.exports = property;
|