lodash.findlast
Advanced tools
Comparing version 3.2.1 to 4.0.0
438
index.js
/** | ||
* lodash 3.2.1 (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 baseCallback = require('lodash._basecallback'), | ||
baseEachRight = require('lodash._baseeachright'), | ||
var baseEachRight = require('lodash._baseeachright'), | ||
baseFind = require('lodash._basefind'), | ||
baseFindIndex = require('lodash._basefindindex'), | ||
isArray = require('lodash.isarray'); | ||
baseIsEqual = require('lodash._baseisequal'), | ||
baseIsMatch = require('lodash._baseismatch'), | ||
get = require('lodash.get'), | ||
hasIn = require('lodash.hasin'), | ||
toPairs = require('lodash.topairs'); | ||
/** Used to compose bitmasks for comparison styles. */ | ||
var UNORDERED_COMPARE_FLAG = 1, | ||
PARTIAL_COMPARE_FLAG = 2; | ||
/** Used as references for various `Number` constants. */ | ||
var INFINITY = 1 / 0; | ||
/** `Object#toString` result references. */ | ||
var symbolTag = '[object Symbol]'; | ||
/** Used to match property names within property paths. */ | ||
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; | ||
/** | ||
* Creates a `_.find` or `_.findLast` function. | ||
* 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 `_.get` without support for default values. | ||
* | ||
* @private | ||
* @param {Function} eachFunc The function to iterate over a collection. | ||
* @param {boolean} [fromRight] Specify iterating from right to left. | ||
* @returns {Function} Returns the new find function. | ||
* @param {Object} object The object to query. | ||
* @param {Array|string} path The path of the property to get. | ||
* @returns {*} Returns the resolved value. | ||
*/ | ||
function createFind(eachFunc, fromRight) { | ||
return function(collection, predicate, thisArg) { | ||
predicate = baseCallback(predicate, thisArg, 3); | ||
if (isArray(collection)) { | ||
var index = baseFindIndex(collection, predicate, fromRight); | ||
return index > -1 ? collection[index] : undefined; | ||
} | ||
return baseFind(collection, predicate, eachFunc); | ||
function baseGet(object, path) { | ||
path = isKey(path, object) ? [path + ''] : baseToPath(path); | ||
var index = 0, | ||
length = path.length; | ||
while (object != null && index < length) { | ||
object = object[path[index++]]; | ||
} | ||
return (index && index == length) ? object : undefined; | ||
} | ||
/** | ||
* The base implementation of `_.iteratee`. | ||
* | ||
* @private | ||
* @param {*} [value=_.identity] The value to convert to an iteratee. | ||
* @returns {Function} Returns the iteratee. | ||
*/ | ||
function baseIteratee(value) { | ||
var type = typeof value; | ||
if (type == 'function') { | ||
return value; | ||
} | ||
if (value == null) { | ||
return identity; | ||
} | ||
if (type == 'object') { | ||
return isArray(value) | ||
? baseMatchesProperty(value[0], value[1]) | ||
: baseMatches(value); | ||
} | ||
return property(value); | ||
} | ||
/** | ||
* The base implementation of `_.matches` which doesn't clone `source`. | ||
* | ||
* @private | ||
* @param {Object} source The object of property values to match. | ||
* @returns {Function} Returns the new function. | ||
*/ | ||
function baseMatches(source) { | ||
var matchData = getMatchData(source); | ||
if (matchData.length == 1 && matchData[0][2]) { | ||
var key = matchData[0][0], | ||
value = matchData[0][1]; | ||
return function(object) { | ||
if (object == null) { | ||
return false; | ||
} | ||
return object[key] === value && | ||
(value !== undefined || (key in Object(object))); | ||
}; | ||
} | ||
return function(object) { | ||
return object === source || baseIsMatch(object, source, matchData); | ||
}; | ||
@@ -35,2 +122,118 @@ } | ||
/** | ||
* The base implementation of `_.matchesProperty` which doesn't clone `srcValue`. | ||
* | ||
* @private | ||
* @param {string} path The path of the property to get. | ||
* @param {*} srcValue The value to match. | ||
* @returns {Function} Returns the new function. | ||
*/ | ||
function baseMatchesProperty(path, srcValue) { | ||
return function(object) { | ||
var objValue = get(object, path); | ||
return (objValue === undefined && objValue === srcValue) | ||
? hasIn(object, path) | ||
: baseIsEqual(srcValue, objValue, undefined, UNORDERED_COMPARE_FLAG | PARTIAL_COMPARE_FLAG); | ||
}; | ||
} | ||
/** | ||
* The base implementation of `_.property` without support for deep paths. | ||
* | ||
* @private | ||
* @param {string} key The key of the property to get. | ||
* @returns {Function} Returns the new function. | ||
*/ | ||
function baseProperty(key) { | ||
return function(object) { | ||
return object == null ? undefined : object[key]; | ||
}; | ||
} | ||
/** | ||
* A specialized version of `baseProperty` which supports deep paths. | ||
* | ||
* @private | ||
* @param {Array|string} path The path of the property to get. | ||
* @returns {Function} Returns the new function. | ||
*/ | ||
function basePropertyDeep(path) { | ||
return function(object) { | ||
return baseGet(object, path); | ||
}; | ||
} | ||
/** | ||
* 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); | ||
} | ||
/** | ||
* Gets the property names, values, and compare flags of `object`. | ||
* | ||
* @private | ||
* @param {Object} object The object to query. | ||
* @returns {Array} Returns the match data of `object`. | ||
*/ | ||
function getMatchData(object) { | ||
var result = toPairs(object), | ||
length = result.length; | ||
while (length--) { | ||
result[length][2] = isStrictComparable(result[length][1]); | ||
} | ||
return result; | ||
} | ||
/** | ||
* Checks if `value` is a property name and not a property path. | ||
* | ||
* @private | ||
* @param {*} value The value to check. | ||
* @param {Object} [object] The object to query keys on. | ||
* @returns {boolean} Returns `true` if `value` is a property name, else `false`. | ||
*/ | ||
function isKey(value, object) { | ||
if (typeof value == 'number') { | ||
return true; | ||
} | ||
return !isArray(value) && | ||
(reIsPlainProp.test(value) || !reIsDeepProp.test(value) || | ||
(object != null && value in Object(object))); | ||
} | ||
/** | ||
* Checks if `value` is suitable for strict equality comparisons, i.e. `===`. | ||
* | ||
* @private | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` if suitable for strict | ||
* equality comparisons, else `false`. | ||
*/ | ||
function isStrictComparable(value) { | ||
return value === value && !isObject(value); | ||
} | ||
/** | ||
* 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; | ||
} | ||
/** | ||
* This method is like `_.find` except that it iterates over elements of | ||
@@ -42,6 +245,4 @@ * `collection` from right to left. | ||
* @category Collection | ||
* @param {Array|Object|string} collection The collection to search. | ||
* @param {Function|Object|string} [predicate=_.identity] The function invoked | ||
* per iteration. | ||
* @param {*} [thisArg] The `this` binding of `predicate`. | ||
* @param {Array|Object} collection The collection to search. | ||
* @param {Function|Object|string} [predicate=_.identity] The function invoked per iteration. | ||
* @returns {*} Returns the matched element, else `undefined`. | ||
@@ -55,4 +256,193 @@ * @example | ||
*/ | ||
var findLast = createFind(baseEachRight, true); | ||
function findLast(collection, predicate) { | ||
predicate = baseIteratee(predicate, 3); | ||
if (isArray(collection)) { | ||
var index = baseFindIndex(collection, predicate, true); | ||
return index > -1 ? collection[index] : undefined; | ||
} | ||
return baseFind(collection, predicate, baseEachRight); | ||
} | ||
/** | ||
* Checks if `value` is classified as an `Array` object. | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @type Function | ||
* @category Lang | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` is correctly classified, else `false`. | ||
* @example | ||
* | ||
* _.isArray([1, 2, 3]); | ||
* // => true | ||
* | ||
* _.isArray(document.body.children); | ||
* // => false | ||
* | ||
* _.isArray('abc'); | ||
* // => false | ||
* | ||
* _.isArray(_.noop); | ||
* // => false | ||
*/ | ||
var isArray = Array.isArray; | ||
/** | ||
* Checks if `value` is the [language type](https://es5.github.io/#x8) of `Object`. | ||
* (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`) | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Lang | ||
* @param {*} value The value to check. | ||
* @returns {boolean} Returns `true` if `value` is an object, else `false`. | ||
* @example | ||
* | ||
* _.isObject({}); | ||
* // => true | ||
* | ||
* _.isObject([1, 2, 3]); | ||
* // => true | ||
* | ||
* _.isObject(_.noop); | ||
* // => true | ||
* | ||
* _.isObject(null); | ||
* // => false | ||
*/ | ||
function isObject(value) { | ||
// Avoid a V8 JIT bug in Chrome 19-20. | ||
// See https://code.google.com/p/v8/issues/detail?id=2291 for more details. | ||
var type = typeof value; | ||
return !!value && (type == 'object' || type == 'function'); | ||
} | ||
/** | ||
* 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 returns the first argument provided to it. | ||
* | ||
* @static | ||
* @memberOf _ | ||
* @category Util | ||
* @param {*} value Any value. | ||
* @returns {*} Returns `value`. | ||
* @example | ||
* | ||
* var object = { 'user': 'fred' }; | ||
* | ||
* _.identity(object) === object; | ||
* // => true | ||
*/ | ||
function identity(value) { | ||
return value; | ||
} | ||
/** | ||
* 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 = findLast; |
{ | ||
"name": "lodash.findlast", | ||
"version": "3.2.1", | ||
"description": "The modern build of lodash’s `_.findLast` as a module.", | ||
"version": "4.0.0", | ||
"description": "The lodash method `_.findLast` 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, findlast", | ||
"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,9 +18,11 @@ ], | ||
"dependencies": { | ||
"lodash._basecallback": "^3.0.0", | ||
"lodash._baseeachright": "^3.0.0", | ||
"lodash._baseeachright": "^4.0.0", | ||
"lodash._basefind": "^3.0.0", | ||
"lodash._basefindindex": "^3.0.0", | ||
"lodash.isarray": "^3.0.0", | ||
"lodash.keys": "^3.0.0" | ||
"lodash._baseisequal": "^4.0.0", | ||
"lodash._baseismatch": "^4.0.0", | ||
"lodash.get": "^4.0.0", | ||
"lodash.hasin": "^4.0.0", | ||
"lodash.topairs": "^4.0.0" | ||
} | ||
} |
@@ -1,4 +0,4 @@ | ||
# lodash.findlast v3.2.1 | ||
# lodash.findlast v4.0.0 | ||
The [modern build](https://github.com/lodash/lodash/wiki/Build-Differences) of [lodash’s](https://lodash.com/) `_.findLast` exported as a [Node.js](http://nodejs.org/)/[io.js](https://iojs.org/) module. | ||
The [lodash](https://lodash.com/) method `_.findLast` 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 findLast = require('lodash.findlast'); | ||
See the [documentation](https://lodash.com/docs#findLast) or [package source](https://github.com/lodash/lodash/blob/3.2.1-npm-packages/lodash.findlast) for more details. | ||
See the [documentation](https://lodash.com/docs#findLast) or [package source](https://github.com/lodash/lodash/blob/4.0.0-npm-packages/lodash.findlast) for more details. |
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
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
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
14335
412
8
19
1
+ Addedlodash._baseisequal@^4.0.0
+ Addedlodash._baseismatch@^4.0.0
+ Addedlodash.get@^4.0.0
+ Addedlodash.hasin@^4.0.0
+ Addedlodash.topairs@^4.0.0
+ Addedlodash._baseeachright@4.1.3(transitive)
+ Addedlodash._baseisequal@4.1.1(transitive)
+ Addedlodash._baseismatch@4.0.2(transitive)
+ Addedlodash._root@3.0.1(transitive)
+ Addedlodash._stack@4.1.3(transitive)
+ Addedlodash.get@4.4.2(transitive)
+ Addedlodash.hasin@4.5.2(transitive)
+ Addedlodash.keys@4.2.0(transitive)
+ Addedlodash.topairs@4.3.0(transitive)
- Removedlodash._basecallback@^3.0.0
- Removedlodash.isarray@^3.0.0
- Removedlodash.keys@^3.0.0
- Removedlodash._basecallback@3.3.1(transitive)
- Removedlodash._baseeachright@3.0.3(transitive)
- Removedlodash._baseforright@3.0.2(transitive)
- Removedlodash._baseisequal@3.0.7(transitive)
- Removedlodash._bindcallback@3.0.1(transitive)
- Removedlodash._getnative@3.9.1(transitive)
- Removedlodash.isarguments@3.1.0(transitive)
- Removedlodash.isarray@3.0.4(transitive)
- Removedlodash.istypedarray@3.0.6(transitive)
- Removedlodash.keys@3.1.2(transitive)
- Removedlodash.pairs@3.0.1(transitive)
Updatedlodash._baseeachright@^4.0.0