1 var arrayEvery = require('./_arrayEvery'),
2 baseEvery = require('./_baseEvery'),
3 baseIteratee = require('./_baseIteratee'),
4 isArray = require('./isArray'),
5 isIterateeCall = require('./_isIterateeCall');
8 * Checks if `predicate` returns truthy for **all** elements of `collection`.
9 * Iteration is stopped once `predicate` returns falsey. The predicate is
10 * invoked with three arguments: (value, index|key, collection).
14 * @category Collection
15 * @param {Array|Object} collection The collection to iterate over.
16 * @param {Function|Object|string} [predicate=_.identity] The function invoked per iteration.
17 * @param- {Object} [guard] Enables use as an iteratee for functions like `_.map`.
18 * @returns {boolean} Returns `true` if all elements pass the predicate check, else `false`.
21 * _.every([true, 1, null, 'yes'], Boolean);
25 * { 'user': 'barney', 'active': false },
26 * { 'user': 'fred', 'active': false }
29 * // The `_.matches` iteratee shorthand.
30 * _.every(users, { 'user': 'barney', 'active': false });
33 * // The `_.matchesProperty` iteratee shorthand.
34 * _.every(users, ['active', false]);
37 * // The `_.property` iteratee shorthand.
38 * _.every(users, 'active');
41 function every(collection, predicate, guard) {
42 var func = isArray(collection) ? arrayEvery : baseEvery;
43 if (guard && isIterateeCall(collection, predicate, guard)) {
44 predicate = undefined;
46 return func(collection, baseIteratee(predicate, 3));
49 module.exports = every;