lodash.result
Advanced tools
Comparing version 3.1.2 to 4.0.0
254
index.js
/** | ||
* lodash 3.1.2 (Custom Build) <https://lodash.com/> | ||
* Build: `lodash modern modularize exports="npm" -o ./` | ||
* Copyright 2012-2015 The Dojo Foundation <http://dojofoundation.org/> | ||
* lodash 4.0.0 (Custom Build) <https://lodash.com/> | ||
* Build: `lodash modularize exports="npm" -o ./` | ||
* Copyright 2012-2016 The Dojo Foundation <http://dojofoundation.org/> | ||
* Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE> | ||
* Copyright 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors | ||
* Copyright 2009-2016 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors | ||
* Available under MIT license <https://lodash.com/license> | ||
*/ | ||
var baseGet = require('lodash._baseget'), | ||
baseSlice = require('lodash._baseslice'), | ||
toPath = require('lodash._topath'), | ||
isArray = require('lodash.isarray'), | ||
isFunction = require('lodash.isfunction'); | ||
var baseSlice = require('lodash._baseslice'), | ||
get = require('lodash.get'); | ||
/** Used as references for various `Number` constants. */ | ||
var INFINITY = 1 / 0; | ||
/** `Object#toString` result references. */ | ||
var funcTag = '[object Function]', | ||
genTag = '[object GeneratorFunction]', | ||
symbolTag = '[object Symbol]'; | ||
/** Used to match property names within property paths. */ | ||
var reIsDeepProp = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\n\\]|\\.)*?\1)\]/, | ||
reIsPlainProp = /^\w*$/; | ||
var reIsDeepProp = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/, | ||
reIsPlainProp = /^\w*$/, | ||
rePropName = /[^.[\]]+|\[(?:(-?\d+(?:\.\d+)?)|(["'])((?:(?!\2)[^\\]|\\.)*?)\2)\]/g; | ||
/** Used to match backslashes in property paths. */ | ||
var reEscapeChar = /\\(\\)?/g; | ||
/** Used for built-in method references. */ | ||
var objectProto = global.Object.prototype; | ||
/** | ||
* Used to resolve the [`toStringTag`](http://ecma-international.org/ecma-262/6.0/#sec-object.prototype.tostring) | ||
* of values. | ||
*/ | ||
var objectToString = objectProto.toString; | ||
/** Built-in value references. */ | ||
var _Symbol = global.Symbol; | ||
/** Used to convert symbols to primitives and strings. */ | ||
var symbolProto = _Symbol ? _Symbol.prototype : undefined, | ||
symbolToString = _Symbol ? symbolProto.toString : undefined; | ||
/** | ||
* The base implementation of `_.toPath` which only converts `value` to a | ||
* path if it's not one. | ||
* | ||
* @private | ||
* @param {*} value The value to process. | ||
* @returns {Array} Returns the property path array. | ||
*/ | ||
function baseToPath(value) { | ||
return isArray(value) ? value : stringToPath(value); | ||
} | ||
/** | ||
* Checks if `value` is a property name and not a property path. | ||
@@ -28,40 +65,84 @@ * | ||
function isKey(value, object) { | ||
var type = typeof value; | ||
if ((type == 'string' && reIsPlainProp.test(value)) || type == 'number') { | ||
if (typeof value == 'number') { | ||
return true; | ||
} | ||
if (isArray(value)) { | ||
return false; | ||
} | ||
var result = !reIsDeepProp.test(value); | ||
return result || (object != null && value in toObject(object)); | ||
return !isArray(value) && | ||
(reIsPlainProp.test(value) || !reIsDeepProp.test(value) || | ||
(object != null && value in Object(object))); | ||
} | ||
/** | ||
* Converts `value` to an object if it's not one. | ||
* Gets the parent value at `path` of `object`. | ||
* | ||
* @private | ||
* @param {*} value The value to process. | ||
* @returns {Object} Returns the object. | ||
* @param {Object} object The object to query. | ||
* @param {Array} path The path to get the parent value of. | ||
* @returns {*} Returns the parent value. | ||
*/ | ||
function toObject(value) { | ||
return isObject(value) ? value : Object(value); | ||
function parent(object, path) { | ||
return path.length == 1 ? object : get(object, baseSlice(path, 0, -1)); | ||
} | ||
/** | ||
* Gets the last element of `array`. | ||
* Converts `string` to a property path array. | ||
* | ||
* @private | ||
* @param {string} string The string to convert. | ||
* @returns {Array} Returns the property path array. | ||
*/ | ||
function stringToPath(string) { | ||
var result = []; | ||
toString(string).replace(rePropName, function(match, number, quote, string) { | ||
result.push(quote ? string.replace(reEscapeChar, '$1') : (number || match)); | ||
}); | ||
return result; | ||
} | ||
/** | ||
* Checks if `value` is classified as an `Array` object. | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Array | ||
* @param {Array} array The array to query. | ||
* @returns {*} Returns the last element of `array`. | ||
* @type Function | ||
* @category Lang | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`. | ||
* @example | ||
* | ||
* _.last([1, 2, 3]); | ||
* // => 3 | ||
* _.isArray([1, 2, 3]); | ||
* // => true | ||
* | ||
* _.isArray(document.body.children); | ||
* // => false | ||
* | ||
* _.isArray('abc'); | ||
* // => false | ||
* | ||
* _.isArray(_.noop); | ||
* // => false | ||
*/ | ||
function last(array) { | ||
var length = array ? array.length : 0; | ||
return length ? array[length - 1] : undefined; | ||
var isArray = Array.isArray; | ||
/** | ||
* Checks if `value` is classified as a `Function` object. | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Lang | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`. | ||
* @example | ||
* | ||
* _.isFunction(_); | ||
* // => true | ||
* | ||
* _.isFunction(/abc/); | ||
* // => false | ||
*/ | ||
function isFunction(value) { | ||
// The use of `Object#toString` avoids issues with the `typeof` operator | ||
// in Safari 8 which returns 'object' for typed array constructors, and | ||
// PhantomJS 1.9 which returns 'function' for `NodeList` instances. | ||
var tag = isObject(value) ? objectToString.call(value) : ''; | ||
return tag == funcTag || tag == genTag; | ||
} | ||
@@ -86,3 +167,6 @@ | ||
* | ||
* _.isObject(1); | ||
* _.isObject(_.noop); | ||
* // => true | ||
* | ||
* _.isObject(null); | ||
* // => false | ||
@@ -98,4 +182,87 @@ */ | ||
/** | ||
* Checks if `value` is object-like. A value is object-like if it's not `null` | ||
* and has a `typeof` result of "object". | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Lang | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` is object-like, else `false`. | ||
* @example | ||
* | ||
* _.isObjectLike({}); | ||
* // => true | ||
* | ||
* _.isObjectLike([1, 2, 3]); | ||
* // => true | ||
* | ||
* _.isObjectLike(_.noop); | ||
* // => false | ||
* | ||
* _.isObjectLike(null); | ||
* // => false | ||
*/ | ||
function isObjectLike(value) { | ||
return !!value && typeof value == 'object'; | ||
} | ||
/** | ||
* Checks if `value` is classified as a `Symbol` primitive or object. | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Lang | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`. | ||
* @example | ||
* | ||
* _.isSymbol(Symbol.iterator); | ||
* // => true | ||
* | ||
* _.isSymbol('abc'); | ||
* // => false | ||
*/ | ||
function isSymbol(value) { | ||
return typeof value == 'symbol' || | ||
(isObjectLike(value) && objectToString.call(value) == symbolTag); | ||
} | ||
/** | ||
* Converts `value` to a string if it's not one. An empty string is returned | ||
* for `null` and `undefined` values. The sign of `-0` is preserved. | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Lang | ||
* @param {*} value The value to process. | ||
* @returns {string} Returns the string. | ||
* @example | ||
* | ||
* _.toString(null); | ||
* // => '' | ||
* | ||
* _.toString(-0); | ||
* // => '-0' | ||
* | ||
* _.toString([1, 2, 3]); | ||
* // => '1,2,3' | ||
*/ | ||
function toString(value) { | ||
// Exit early for strings to avoid a performance hit in some environments. | ||
if (typeof value == 'string') { | ||
return value; | ||
} | ||
if (value == null) { | ||
return ''; | ||
} | ||
if (isSymbol(value)) { | ||
return _Symbol ? symbolToString.call(value) : ''; | ||
} | ||
var result = (value + ''); | ||
return (result == '0' && (1 / value) == -INFINITY) ? '-0' : result; | ||
} | ||
/** | ||
* This method is like `_.get` except that if the resolved value is a function | ||
* it is invoked with the `this` binding of its parent object and its result | ||
* it's invoked with the `this` binding of its parent object and its result | ||
* is returned. | ||
@@ -120,17 +287,18 @@ * | ||
* | ||
* _.result(object, 'a.b.c', 'default'); | ||
* _.result(object, 'a[0].b.c3', 'default'); | ||
* // => 'default' | ||
* | ||
* _.result(object, 'a.b.c', _.constant('default')); | ||
* _.result(object, 'a[0].b.c3', _.constant('default')); | ||
* // => 'default' | ||
*/ | ||
function result(object, path, defaultValue) { | ||
var result = object == null ? undefined : object[path]; | ||
if (!isKey(path, object)) { | ||
path = baseToPath(path); | ||
var result = get(object, path); | ||
object = parent(object, path); | ||
} else { | ||
result = object == null ? undefined : object[path]; | ||
} | ||
if (result === undefined) { | ||
if (object != null && !isKey(path, object)) { | ||
path = toPath(path); | ||
object = path.length == 1 ? object : baseGet(object, baseSlice(path, 0, -1)); | ||
result = object == null ? undefined : object[last(path)]; | ||
} | ||
result = result === undefined ? defaultValue : result; | ||
result = defaultValue; | ||
} | ||
@@ -137,0 +305,0 @@ return isFunction(result) ? result.call(object) : result; |
{ | ||
"name": "lodash.result", | ||
"version": "3.1.2", | ||
"description": "The modern build of lodash’s `_.result` as a module.", | ||
"version": "4.0.0", | ||
"description": "The lodash method `_.result` exported as a module.", | ||
"homepage": "https://lodash.com/", | ||
"icon": "https://lodash.com/icon.svg", | ||
"license": "MIT", | ||
"keywords": "lodash, lodash-modularized, stdlib, util", | ||
"keywords": "lodash, lodash-modularized, stdlib, util, result", | ||
"author": "John-David Dalton <john.david.dalton@gmail.com> (http://allyoucanleet.com/)", | ||
"contributors": [ | ||
"John-David Dalton <john.david.dalton@gmail.com> (http://allyoucanleet.com/)", | ||
"Benjamin Tan <demoneaux@gmail.com> (https://d10.github.io/)", | ||
"Blaine Bublitz <blaine@iceddev.com> (http://www.iceddev.com/)", | ||
"Kit Cambridge <github@kitcambridge.be> (http://kitcambridge.be/)", | ||
"Blaine Bublitz <blaine@iceddev.com> (https://github.com/phated)", | ||
"Mathias Bynens <mathias@qiwi.be> (https://mathiasbynens.be/)" | ||
@@ -20,8 +18,5 @@ ], | ||
"dependencies": { | ||
"lodash._baseget": "^3.0.0", | ||
"lodash._baseslice": "^3.0.0", | ||
"lodash._topath": "^3.0.0", | ||
"lodash.isarray": "^3.0.0", | ||
"lodash.isfunction": "^3.0.0" | ||
"lodash._baseslice": "^4.0.0", | ||
"lodash.get": "^4.0.0" | ||
} | ||
} |
@@ -1,4 +0,4 @@ | ||
# lodash.result v3.1.2 | ||
# lodash.result v4.0.0 | ||
The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash’s](https://lodash.com/) `_.result` exported as a [Node.js](http://nodejs.org/)/[io.js](https://iojs.org/) module. | ||
The [lodash](https://lodash.com/) method `_.result` exported as a [Node.js](https://nodejs.org/) module. | ||
@@ -8,3 +8,2 @@ ## Installation | ||
Using npm: | ||
```bash | ||
@@ -15,4 +14,3 @@ $ {sudo -H} npm i -g npm | ||
In Node.js/io.js: | ||
In Node.js: | ||
```js | ||
@@ -22,2 +20,2 @@ var result = require('lodash.result'); | ||
See the [documentation](https://lodash.com/docs#result) or [package source](https://github.com/lodash/lodash/blob/3.1.2-npm-packages/lodash.result) for more details. | ||
See the [documentation](https://lodash.com/docs#result) or [package source](https://github.com/lodash/lodash/blob/4.0.0-npm-packages/lodash.result) for more details. |
Major refactor
Supply chain riskPackage has recently undergone a major refactor. It may be unstable or indicate significant internal changes. Use caution when updating to versions that include significant changes.
Found 1 instance in 1 package
10601
2
284
19
1
+ Addedlodash.get@^4.0.0
+ Addedlodash._baseslice@4.0.0(transitive)
+ Addedlodash.get@4.4.2(transitive)
- Removedlodash._baseget@^3.0.0
- Removedlodash._topath@^3.0.0
- Removedlodash.isarray@^3.0.0
- Removedlodash.isfunction@^3.0.0
- Removedlodash._baseget@3.7.2(transitive)
- Removedlodash._baseslice@3.0.3(transitive)
- Removedlodash._topath@3.8.1(transitive)
- Removedlodash.isarray@3.0.4(transitive)
- Removedlodash.isfunction@3.0.9(transitive)
Updatedlodash._baseslice@^4.0.0