.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / deep-extend / lib / deep-extend.js
1 /*!
2  * @description Recursive object extending
3  * @author Viacheslav Lotsmanov <lotsmanov89@gmail.com>
4  * @license MIT
5  *
6  * The MIT License (MIT)
7  *
8  * Copyright (c) 2013-2018 Viacheslav Lotsmanov
9  *
10  * Permission is hereby granted, free of charge, to any person obtaining a copy of
11  * this software and associated documentation files (the "Software"), to deal in
12  * the Software without restriction, including without limitation the rights to
13  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
14  * the Software, and to permit persons to whom the Software is furnished to do so,
15  * subject to the following conditions:
16  *
17  * The above copyright notice and this permission notice shall be included in all
18  * copies or substantial portions of the Software.
19  *
20  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
22  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
23  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
24  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
25  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26  */
27
28 'use strict';
29
30 function isSpecificValue(val) {
31         return (
32                 val instanceof Buffer
33                 || val instanceof Date
34                 || val instanceof RegExp
35         ) ? true : false;
36 }
37
38 function cloneSpecificValue(val) {
39         if (val instanceof Buffer) {
40                 var x = Buffer.alloc
41                         ? Buffer.alloc(val.length)
42                         : new Buffer(val.length);
43                 val.copy(x);
44                 return x;
45         } else if (val instanceof Date) {
46                 return new Date(val.getTime());
47         } else if (val instanceof RegExp) {
48                 return new RegExp(val);
49         } else {
50                 throw new Error('Unexpected situation');
51         }
52 }
53
54 /**
55  * Recursive cloning array.
56  */
57 function deepCloneArray(arr) {
58         var clone = [];
59         arr.forEach(function (item, index) {
60                 if (typeof item === 'object' && item !== null) {
61                         if (Array.isArray(item)) {
62                                 clone[index] = deepCloneArray(item);
63                         } else if (isSpecificValue(item)) {
64                                 clone[index] = cloneSpecificValue(item);
65                         } else {
66                                 clone[index] = deepExtend({}, item);
67                         }
68                 } else {
69                         clone[index] = item;
70                 }
71         });
72         return clone;
73 }
74
75 function safeGetProperty(object, property) {
76         return property === '__proto__' ? undefined : object[property];
77 }
78
79 /**
80  * Extening object that entered in first argument.
81  *
82  * Returns extended object or false if have no target object or incorrect type.
83  *
84  * If you wish to clone source object (without modify it), just use empty new
85  * object as first argument, like this:
86  *   deepExtend({}, yourObj_1, [yourObj_N]);
87  */
88 var deepExtend = module.exports = function (/*obj_1, [obj_2], [obj_N]*/) {
89         if (arguments.length < 1 || typeof arguments[0] !== 'object') {
90                 return false;
91         }
92
93         if (arguments.length < 2) {
94                 return arguments[0];
95         }
96
97         var target = arguments[0];
98
99         // convert arguments to array and cut off target object
100         var args = Array.prototype.slice.call(arguments, 1);
101
102         var val, src, clone;
103
104         args.forEach(function (obj) {
105                 // skip argument if isn't an object, is null, or is an array
106                 if (typeof obj !== 'object' || obj === null || Array.isArray(obj)) {
107                         return;
108                 }
109
110                 Object.keys(obj).forEach(function (key) {
111                         src = safeGetProperty(target, key); // source value
112                         val = safeGetProperty(obj, key); // new value
113
114                         // recursion prevention
115                         if (val === target) {
116                                 return;
117
118                         /**
119                          * if new value isn't object then just overwrite by new value
120                          * instead of extending.
121                          */
122                         } else if (typeof val !== 'object' || val === null) {
123                                 target[key] = val;
124                                 return;
125
126                         // just clone arrays (and recursive clone objects inside)
127                         } else if (Array.isArray(val)) {
128                                 target[key] = deepCloneArray(val);
129                                 return;
130
131                         // custom cloning and overwrite for specific objects
132                         } else if (isSpecificValue(val)) {
133                                 target[key] = cloneSpecificValue(val);
134                                 return;
135
136                         // overwrite by new value if source isn't object or array
137                         } else if (typeof src !== 'object' || src === null || Array.isArray(src)) {
138                                 target[key] = deepExtend({}, val);
139                                 return;
140
141                         // source value and new value is objects both, extending...
142                         } else {
143                                 target[key] = deepExtend(src, val);
144                                 return;
145                         }
146                 });
147         });
148
149         return target;
150 };