@newdash/newdash/iteratee.js

javascript/typescript utility library

"use strict";
var __importDefault = (this && this.__importDefault) || function (mod) {
    return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const baseIteratee_1 = __importDefault(require("./.internal/baseIteratee"));
const baseClone_1 = __importDefault(require("./.internal/baseClone"));
const CLONE_DEEP_FLAG = 1;
/**
 * Creates a function that invokes `func` with the arguments of the created
 * function. If `func` is a property name, the created function returns the
 * property value for a given element. If `func` is an array or object, the
 * created function returns `true` for elements that contain the equivalent
 * source properties, otherwise it returns `false`.
 *
 * @since 5.5.0
 * @category Util
 * @param func The value to convert to a callback.
 * @returns Returns the callback.
 * @example
 *
 * ```js
 * var users = [
 *   { 'user': 'barney', 'age': 36, 'active': true },
 *   { 'user': 'fred',   'age': 40, 'active': false }
 * ];
 *
 * // The `matches` iteratee shorthand.
 * filter(users, iteratee({ 'user': 'barney', 'active': true }));
 * // => [{ 'user': 'barney', 'age': 36, 'active': true }]
 *
 * // The `matchesProperty` iteratee shorthand.
 * filter(users, iteratee(['user', 'fred']));
 * // => [{ 'user': 'fred', 'age': 40 }]
 *
 * // The `property` iteratee shorthand.
 * map(users, iteratee('user'));
 * // => ['barney', 'fred']
 *
 * // Create custom iteratee shorthands.
 * iteratee = wrap(iteratee, function(iteratee, func) {
 *   return !isRegExp(func) ? iteratee(func) : function(string) {
 *     return func.test(string);
 *   };
 * });
 *
 * filter(['abc', 'def'], /ef/);
 * // => ['def']
 * ```
 */
function iteratee(func) {
    // @ts-ignore
    return (0, baseIteratee_1.default)(typeof func == "function" ? func : (0, baseClone_1.default)(func, CLONE_DEEP_FLAG));
}
exports.default = iteratee;