Press n or j to go to the next uncovered block, b, p or k for the previous block.
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 | 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 3x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 21x 56x 56x 56x 56x 56x 56x 56x 4x 4x 56x 16x 16x 36x 56x 38x 38x 38x 38x 16x 16x 22x 22x 56x 22x 22x 20x 56x 21x 3x 3x 3x 3x 3x | /**
* @license Apache-2.0
*
* Copyright (c) 2018 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
'use strict';
// MODULES //
var isObject = require( '@stdlib/assert/is-object' );
var format = require( '@stdlib/string/format' );
var deepMerge = require( './deepmerge.js' );
// MAIN //
/**
* Returns a merge function based on provided options.
*
* @private
* @param {Options} opts - function options
* @param {number} options.level - merge level
* @param {boolean} options.copy - boolean indicating whether to deep copy merged values
* @param {(boolean|Function)} options.override - defines the merge strategy
* @param {boolean} options.extend - boolean indicating whether new properties can be added to the target object
* @returns {Function} merge function
*
* @example
* var merge = mergefcn({
* 'level': Number.POSITIVE_INFINITY,
* 'copy': true,
* 'override': true,
* 'extend': true
* });
* // returns <Function>
*/
function mergefcn( opts ) {
return merge;
/**
* Merges objects into a target object. Note that the target object is mutated.
*
* @private
* @param {Object} target - target object
* @param {...Object} source - source objects (i.e., objects to be merged into the target object)
* @throws {Error} must provide a target object and one or more source objects
* @throws {TypeError} first argument must be an object
* @throws {TypeError} source arguments must be objects
* @returns {Object} merged (target) object
*
* @example
* var target = {
* 'a': 'beep'
* };
* var source = {
* 'a': 'boop',
* 'b': 'bap'
* };
*
* var out = merge( target, source );
* // returns {'a':'boop', 'b':'bap'}
*/
function merge( target ) {
var nargs;
var arg;
var src;
var i;
nargs = arguments.length - 1;
if ( nargs < 1 ) {
throw new Error( 'insufficient arguments. Must provide both a target object and one or more source objects.' );
}
if ( !isObject( target ) ) {
throw new TypeError( format( 'invalid argument. First argument must be an object. Value: `%s`.', target ) );
}
src = new Array( nargs );
for ( i = 0; i < nargs; i++ ) {
arg = arguments[ i+1 ];
// WARNING: this is a porous check. Buffers, Numbers, Booleans, Strings, Dates, RegExp, custom class instances,... will all pass.
if ( !isObject( arg ) ) {
throw new TypeError( format( 'invalid argument. All arguments must be objects. Index: `%u`. Value: `%s`.', i, arg ) );
}
src[ i ] = arg;
}
for ( i = 0; i < nargs; i++ ) {
deepMerge( target, src[ i ], opts.level, opts.copy, opts.override, opts.extend ); // eslint-disable-line max-len
}
return target;
}
}
// EXPORTS //
module.exports = mergefcn;
|