[d565449] | 1 | import arrayEach from './_arrayEach.js';
|
---|
| 2 | import arrayPush from './_arrayPush.js';
|
---|
| 3 | import baseFunctions from './_baseFunctions.js';
|
---|
| 4 | import copyArray from './_copyArray.js';
|
---|
| 5 | import isFunction from './isFunction.js';
|
---|
| 6 | import isObject from './isObject.js';
|
---|
| 7 | import keys from './keys.js';
|
---|
| 8 |
|
---|
| 9 | /**
|
---|
| 10 | * Adds all own enumerable string keyed function properties of a source
|
---|
| 11 | * object to the destination object. If `object` is a function, then methods
|
---|
| 12 | * are added to its prototype as well.
|
---|
| 13 | *
|
---|
| 14 | * **Note:** Use `_.runInContext` to create a pristine `lodash` function to
|
---|
| 15 | * avoid conflicts caused by modifying the original.
|
---|
| 16 | *
|
---|
| 17 | * @static
|
---|
| 18 | * @since 0.1.0
|
---|
| 19 | * @memberOf _
|
---|
| 20 | * @category Util
|
---|
| 21 | * @param {Function|Object} [object=lodash] The destination object.
|
---|
| 22 | * @param {Object} source The object of functions to add.
|
---|
| 23 | * @param {Object} [options={}] The options object.
|
---|
| 24 | * @param {boolean} [options.chain=true] Specify whether mixins are chainable.
|
---|
| 25 | * @returns {Function|Object} Returns `object`.
|
---|
| 26 | * @example
|
---|
| 27 | *
|
---|
| 28 | * function vowels(string) {
|
---|
| 29 | * return _.filter(string, function(v) {
|
---|
| 30 | * return /[aeiou]/i.test(v);
|
---|
| 31 | * });
|
---|
| 32 | * }
|
---|
| 33 | *
|
---|
| 34 | * _.mixin({ 'vowels': vowels });
|
---|
| 35 | * _.vowels('fred');
|
---|
| 36 | * // => ['e']
|
---|
| 37 | *
|
---|
| 38 | * _('fred').vowels().value();
|
---|
| 39 | * // => ['e']
|
---|
| 40 | *
|
---|
| 41 | * _.mixin({ 'vowels': vowels }, { 'chain': false });
|
---|
| 42 | * _('fred').vowels();
|
---|
| 43 | * // => ['e']
|
---|
| 44 | */
|
---|
| 45 | function mixin(object, source, options) {
|
---|
| 46 | var props = keys(source),
|
---|
| 47 | methodNames = baseFunctions(source, props);
|
---|
| 48 |
|
---|
| 49 | var chain = !(isObject(options) && 'chain' in options) || !!options.chain,
|
---|
| 50 | isFunc = isFunction(object);
|
---|
| 51 |
|
---|
| 52 | arrayEach(methodNames, function(methodName) {
|
---|
| 53 | var func = source[methodName];
|
---|
| 54 | object[methodName] = func;
|
---|
| 55 | if (isFunc) {
|
---|
| 56 | object.prototype[methodName] = function() {
|
---|
| 57 | var chainAll = this.__chain__;
|
---|
| 58 | if (chain || chainAll) {
|
---|
| 59 | var result = object(this.__wrapped__),
|
---|
| 60 | actions = result.__actions__ = copyArray(this.__actions__);
|
---|
| 61 |
|
---|
| 62 | actions.push({ 'func': func, 'args': arguments, 'thisArg': object });
|
---|
| 63 | result.__chain__ = chainAll;
|
---|
| 64 | return result;
|
---|
| 65 | }
|
---|
| 66 | return func.apply(object, arrayPush([this.value()], arguments));
|
---|
| 67 | };
|
---|
| 68 | }
|
---|
| 69 | });
|
---|
| 70 |
|
---|
| 71 | return object;
|
---|
| 72 | }
|
---|
| 73 |
|
---|
| 74 | export default mixin;
|
---|