504 lines
13 KiB
JavaScript
504 lines
13 KiB
JavaScript
|
/**
|
||
|
|
* lodash (Custom Build) <https://lodash.com/>
|
||
|
|
* Build: `lodash modularize exports="npm" -o ./`
|
||
|
|
* Copyright jQuery Foundation and other contributors <https://jquery.org/>
|
||
|
|
* Released under MIT license <https://lodash.com/license>
|
||
|
|
* Based on Underscore.js 1.8.3 <http://underscorejs.org/LICENSE>
|
||
|
|
* Copyright Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
|
||
|
|
*/
|
||
|
|
|
||
|
|
/** Used as references for various `Number` constants. */
|
||
|
|
var INFINITY = 1 / 0,
|
||
|
|
MAX_SAFE_INTEGER = 9007199254740991;
|
||
|
|
|
||
|
|
/** `Object#toString` result references. */
|
||
|
|
var argsTag = '[object Arguments]',
|
||
|
|
funcTag = '[object Function]',
|
||
|
|
genTag = '[object GeneratorFunction]',
|
||
|
|
symbolTag = '[object Symbol]';
|
||
|
|
|
||
|
|
/** Detect free variable `global` from Node.js. */
|
||
|
|
var freeGlobal = typeof global == 'object' && global && global.Object === Object && global;
|
||
|
|
|
||
|
|
/** Detect free variable `self`. */
|
||
|
|
var freeSelf = typeof self == 'object' && self && self.Object === Object && self;
|
||
|
|
|
||
|
|
/** Used as a reference to the global object. */
|
||
|
|
var root = freeGlobal || freeSelf || Function('return this')();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A faster alternative to `Function#apply`, this function invokes `func`
|
||
|
|
* with the `this` binding of `thisArg` and the arguments of `args`.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Function} func The function to invoke.
|
||
|
|
* @param {*} thisArg The `this` binding of `func`.
|
||
|
|
* @param {Array} args The arguments to invoke `func` with.
|
||
|
|
* @returns {*} Returns the result of `func`.
|
||
|
|
*/
|
||
|
|
function apply(func, thisArg, args) {
|
||
|
|
switch (args.length) {
|
||
|
|
case 0: return func.call(thisArg);
|
||
|
|
case 1: return func.call(thisArg, args[0]);
|
||
|
|
case 2: return func.call(thisArg, args[0], args[1]);
|
||
|
|
case 3: return func.call(thisArg, args[0], args[1], args[2]);
|
||
|
|
}
|
||
|
|
return func.apply(thisArg, args);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* A specialized version of `_.map` for arrays without support for iteratee
|
||
|
|
* shorthands.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Array} [array] The array to iterate over.
|
||
|
|
* @param {Function} iteratee The function invoked per iteration.
|
||
|
|
* @returns {Array} Returns the new mapped array.
|
||
|
|
*/
|
||
|
|
function arrayMap(array, iteratee) {
|
||
|
|
var index = -1,
|
||
|
|
length = array ? array.length : 0,
|
||
|
|
result = Array(length);
|
||
|
|
|
||
|
|
while (++index < length) {
|
||
|
|
result[index] = iteratee(array[index], index, array);
|
||
|
|
}
|
||
|
|
return result;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Appends the elements of `values` to `array`.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Array} array The array to modify.
|
||
|
|
* @param {Array} values The values to append.
|
||
|
|
* @returns {Array} Returns `array`.
|
||
|
|
*/
|
||
|
|
function arrayPush(array, values) {
|
||
|
|
var index = -1,
|
||
|
|
length = values.length,
|
||
|
|
offset = array.length;
|
||
|
|
|
||
|
|
while (++index < length) {
|
||
|
|
array[offset + index] = values[index];
|
||
|
|
}
|
||
|
|
return array;
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Used for built-in method references. */
|
||
|
|
var objectProto = Object.prototype;
|
||
|
|
|
||
|
|
/** Used to check objects for own properties. */
|
||
|
|
var hasOwnProperty = objectProto.hasOwnProperty;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Used to resolve the
|
||
|
|
* [`toStringTag`](http://ecma-international.org/ecma-262/7.0/#sec-object.prototype.tostring)
|
||
|
|
* of values.
|
||
|
|
*/
|
||
|
|
var objectToString = objectProto.toString;
|
||
|
|
|
||
|
|
/** Built-in value references. */
|
||
|
|
var Symbol = root.Symbol,
|
||
|
|
propertyIsEnumerable = objectProto.propertyIsEnumerable,
|
||
|
|
spreadableSymbol = Symbol ? Symbol.isConcatSpreadable : undefined;
|
||
|
|
|
||
|
|
/* Built-in method references for those with the same name as other `lodash` methods. */
|
||
|
|
var nativeMax = Math.max;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The base implementation of `_.flatten` with support for restricting flattening.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Array} array The array to flatten.
|
||
|
|
* @param {number} depth The maximum recursion depth.
|
||
|
|
* @param {boolean} [predicate=isFlattenable] The function invoked per iteration.
|
||
|
|
* @param {boolean} [isStrict] Restrict to values that pass `predicate` checks.
|
||
|
|
* @param {Array} [result=[]] The initial result value.
|
||
|
|
* @returns {Array} Returns the new flattened array.
|
||
|
|
*/
|
||
|
|
function baseFlatten(array, depth, predicate, isStrict, result) {
|
||
|
|
var index = -1,
|
||
|
|
length = array.length;
|
||
|
|
|
||
|
|
predicate || (predicate = isFlattenable);
|
||
|
|
result || (result = []);
|
||
|
|
|
||
|
|
while (++index < length) {
|
||
|
|
var value = array[index];
|
||
|
|
if (depth > 0 && predicate(value)) {
|
||
|
|
if (depth > 1) {
|
||
|
|
// Recursively flatten arrays (susceptible to call stack limits).
|
||
|
|
baseFlatten(value, depth - 1, predicate, isStrict, result);
|
||
|
|
} else {
|
||
|
|
arrayPush(result, value);
|
||
|
|
}
|
||
|
|
} else if (!isStrict) {
|
||
|
|
result[result.length] = value;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return result;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The base implementation of `_.pick` without support for individual
|
||
|
|
* property identifiers.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Object} object The source object.
|
||
|
|
* @param {string[]} props The property identifiers to pick.
|
||
|
|
* @returns {Object} Returns the new object.
|
||
|
|
*/
|
||
|
|
function basePick(object, props) {
|
||
|
|
object = Object(object);
|
||
|
|
return basePickBy(object, props, function(value, key) {
|
||
|
|
return key in object;
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The base implementation of `_.pickBy` without support for iteratee shorthands.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Object} object The source object.
|
||
|
|
* @param {string[]} props The property identifiers to pick from.
|
||
|
|
* @param {Function} predicate The function invoked per property.
|
||
|
|
* @returns {Object} Returns the new object.
|
||
|
|
*/
|
||
|
|
function basePickBy(object, props, predicate) {
|
||
|
|
var index = -1,
|
||
|
|
length = props.length,
|
||
|
|
result = {};
|
||
|
|
|
||
|
|
while (++index < length) {
|
||
|
|
var key = props[index],
|
||
|
|
value = object[key];
|
||
|
|
|
||
|
|
if (predicate(value, key)) {
|
||
|
|
result[key] = value;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return result;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* The base implementation of `_.rest` which doesn't validate or coerce arguments.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {Function} func The function to apply a rest parameter to.
|
||
|
|
* @param {number} [start=func.length-1] The start position of the rest parameter.
|
||
|
|
* @returns {Function} Returns the new function.
|
||
|
|
*/
|
||
|
|
function baseRest(func, start) {
|
||
|
|
start = nativeMax(start === undefined ? (func.length - 1) : start, 0);
|
||
|
|
return function() {
|
||
|
|
var args = arguments,
|
||
|
|
index = -1,
|
||
|
|
length = nativeMax(args.length - start, 0),
|
||
|
|
array = Array(length);
|
||
|
|
|
||
|
|
while (++index < length) {
|
||
|
|
array[index] = args[start + index];
|
||
|
|
}
|
||
|
|
index = -1;
|
||
|
|
var otherArgs = Array(start + 1);
|
||
|
|
while (++index < start) {
|
||
|
|
otherArgs[index] = args[index];
|
||
|
|
}
|
||
|
|
otherArgs[start] = array;
|
||
|
|
return apply(func, this, otherArgs);
|
||
|
|
};
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if `value` is a flattenable `arguments` object or array.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is flattenable, else `false`.
|
||
|
|
*/
|
||
|
|
function isFlattenable(value) {
|
||
|
|
return isArray(value) || isArguments(value) ||
|
||
|
|
!!(spreadableSymbol && value && value[spreadableSymbol]);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Converts `value` to a string key if it's not a string or symbol.
|
||
|
|
*
|
||
|
|
* @private
|
||
|
|
* @param {*} value The value to inspect.
|
||
|
|
* @returns {string|symbol} Returns the key.
|
||
|
|
*/
|
||
|
|
function toKey(value) {
|
||
|
|
if (typeof value == 'string' || isSymbol(value)) {
|
||
|
|
return value;
|
||
|
|
}
|
||
|
|
var result = (value + '');
|
||
|
|
return (result == '0' && (1 / value) == -INFINITY) ? '-0' : result;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if `value` is likely an `arguments` object.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 0.1.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is an `arguments` object,
|
||
|
|
* else `false`.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.isArguments(function() { return arguments; }());
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isArguments([1, 2, 3]);
|
||
|
|
* // => false
|
||
|
|
*/
|
||
|
|
function isArguments(value) {
|
||
|
|
// Safari 8.1 makes `arguments.callee` enumerable in strict mode.
|
||
|
|
return isArrayLikeObject(value) && hasOwnProperty.call(value, 'callee') &&
|
||
|
|
(!propertyIsEnumerable.call(value, 'callee') || objectToString.call(value) == argsTag);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if `value` is classified as an `Array` object.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 0.1.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is an array, 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 array-like. A value is considered array-like if it's
|
||
|
|
* not a function and has a `value.length` that's an integer greater than or
|
||
|
|
* equal to `0` and less than or equal to `Number.MAX_SAFE_INTEGER`.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 4.0.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is array-like, else `false`.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.isArrayLike([1, 2, 3]);
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isArrayLike(document.body.children);
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isArrayLike('abc');
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isArrayLike(_.noop);
|
||
|
|
* // => false
|
||
|
|
*/
|
||
|
|
function isArrayLike(value) {
|
||
|
|
return value != null && isLength(value.length) && !isFunction(value);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* This method is like `_.isArrayLike` except that it also checks if `value`
|
||
|
|
* is an object.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 4.0.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is an array-like object,
|
||
|
|
* else `false`.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.isArrayLikeObject([1, 2, 3]);
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isArrayLikeObject(document.body.children);
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isArrayLikeObject('abc');
|
||
|
|
* // => false
|
||
|
|
*
|
||
|
|
* _.isArrayLikeObject(_.noop);
|
||
|
|
* // => false
|
||
|
|
*/
|
||
|
|
function isArrayLikeObject(value) {
|
||
|
|
return isObjectLike(value) && isArrayLike(value);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if `value` is classified as a `Function` object.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 0.1.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is a function, 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-9 which returns 'object' for typed array and other constructors.
|
||
|
|
var tag = isObject(value) ? objectToString.call(value) : '';
|
||
|
|
return tag == funcTag || tag == genTag;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if `value` is a valid array-like length.
|
||
|
|
*
|
||
|
|
* **Note:** This method is loosely based on
|
||
|
|
* [`ToLength`](http://ecma-international.org/ecma-262/7.0/#sec-tolength).
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 4.0.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is a valid length, else `false`.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.isLength(3);
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isLength(Number.MIN_VALUE);
|
||
|
|
* // => false
|
||
|
|
*
|
||
|
|
* _.isLength(Infinity);
|
||
|
|
* // => false
|
||
|
|
*
|
||
|
|
* _.isLength('3');
|
||
|
|
* // => false
|
||
|
|
*/
|
||
|
|
function isLength(value) {
|
||
|
|
return typeof value == 'number' &&
|
||
|
|
value > -1 && value % 1 == 0 && value <= MAX_SAFE_INTEGER;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Checks if `value` is the
|
||
|
|
* [language type](http://www.ecma-international.org/ecma-262/7.0/#sec-ecmascript-language-types)
|
||
|
|
* of `Object`. (e.g. arrays, functions, objects, regexes, `new Number(0)`, and `new String('')`)
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @memberOf _
|
||
|
|
* @since 0.1.0
|
||
|
|
* @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) {
|
||
|
|
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 _
|
||
|
|
* @since 4.0.0
|
||
|
|
* @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 _
|
||
|
|
* @since 4.0.0
|
||
|
|
* @category Lang
|
||
|
|
* @param {*} value The value to check.
|
||
|
|
* @returns {boolean} Returns `true` if `value` is a symbol, else `false`.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* _.isSymbol(Symbol.iterator);
|
||
|
|
* // => true
|
||
|
|
*
|
||
|
|
* _.isSymbol('abc');
|
||
|
|
* // => false
|
||
|
|
*/
|
||
|
|
function isSymbol(value) {
|
||
|
|
return typeof value == 'symbol' ||
|
||
|
|
(isObjectLike(value) && objectToString.call(value) == symbolTag);
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Creates an object composed of the picked `object` properties.
|
||
|
|
*
|
||
|
|
* @static
|
||
|
|
* @since 0.1.0
|
||
|
|
* @memberOf _
|
||
|
|
* @category Object
|
||
|
|
* @param {Object} object The source object.
|
||
|
|
* @param {...(string|string[])} [props] The property identifiers to pick.
|
||
|
|
* @returns {Object} Returns the new object.
|
||
|
|
* @example
|
||
|
|
*
|
||
|
|
* var object = { 'a': 1, 'b': '2', 'c': 3 };
|
||
|
|
*
|
||
|
|
* _.pick(object, ['a', 'c']);
|
||
|
|
* // => { 'a': 1, 'c': 3 }
|
||
|
|
*/
|
||
|
|
var pick = baseRest(function(object, props) {
|
||
|
|
return object == null ? {} : basePick(object, arrayMap(baseFlatten(props, 1), toKey));
|
||
|
|
});
|
||
|
|
|
||
|
|
module.exports = pick;
|