| var castPath = require('./_castPath'), |
| isFunction = require('./isFunction'), |
| toKey = require('./_toKey'); |
| |
| /** |
| * This method is like `_.get` except that if the resolved value is a |
| * function it's invoked with the `this` binding of its parent object and |
| * its result is returned. |
| * |
| * @static |
| * @since 0.1.0 |
| * @memberOf _ |
| * @category Object |
| * @param {Object} object The object to query. |
| * @param {Array|string} path The path of the property to resolve. |
| * @param {*} [defaultValue] The value returned for `undefined` resolved values. |
| * @returns {*} Returns the resolved value. |
| * @example |
| * |
| * var object = { 'a': [{ 'b': { 'c1': 3, 'c2': _.constant(4) } }] }; |
| * |
| * _.result(object, 'a[0].b.c1'); |
| * // => 3 |
| * |
| * _.result(object, 'a[0].b.c2'); |
| * // => 4 |
| * |
| * _.result(object, 'a[0].b.c3', 'default'); |
| * // => 'default' |
| * |
| * _.result(object, 'a[0].b.c3', _.constant('default')); |
| * // => 'default' |
| */ |
| function result(object, path, defaultValue) { |
| path = castPath(path, object); |
| |
| var index = -1, |
| length = path.length; |
| |
| // Ensure the loop is entered when path is empty. |
| if (!length) { |
| length = 1; |
| object = undefined; |
| } |
| while (++index < length) { |
| var value = object == null ? undefined : object[toKey(path[index])]; |
| if (value === undefined) { |
| index = length; |
| value = defaultValue; |
| } |
| object = isFunction(value) ? value.call(object) : value; |
| } |
| return object; |
| } |
| |
| module.exports = result; |