UNPKG

1.04 kBJavaScriptView Raw
1var arraySome = require('./_arraySome'),
2 createOver = require('./_createOver');
3
4/**
5 * Creates a function that checks if **any** of the `predicates` return
6 * truthy when invoked with the arguments it receives.
7 *
8 * Following shorthands are possible for providing predicates.
9 * Pass an `Object` and it will be used as an parameter for `_.matches` to create the predicate.
10 * Pass an `Array` of parameters for `_.matchesProperty` and the predicate will be created using them.
11 *
12 * @static
13 * @memberOf _
14 * @since 4.0.0
15 * @category Util
16 * @param {...(Function|Function[])} [predicates=[_.identity]]
17 * The predicates to check.
18 * @returns {Function} Returns the new function.
19 * @example
20 *
21 * var func = _.overSome([Boolean, isFinite]);
22 *
23 * func('1');
24 * // => true
25 *
26 * func(null);
27 * // => true
28 *
29 * func(NaN);
30 * // => false
31 *
32 * var matchesFunc = _.overSome([{ 'a': 1 }, { 'a': 2 }])
33 * var matchesPropertyFunc = _.overSome([['a', 1], ['a', 2]])
34 */
35var overSome = createOver(arraySome);
36
37module.exports = overSome;