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
|
# Merge
(recursive)? merging of (cloned)? objects.
# Install
## Node.js
```sh
npm i merge
```
```js
import merge from 'merge'
```
## Browser
```html
<script src="https://cdn.jsdelivr.net/gh/yeikos/js.merge/dist/merge.browser.min.js"></script>
```
```js
window.merge
```
# API
```typescript
merge(clone: boolean, ...items: Object[])
merge(...items: Object[])
merge.recursive(clone: boolean, ...items: Object[])
merge.recursive(...items: Object[])
```
# Examples
```js
// Merge
{
var objectA = {}
merge(objectA,
{ value: 1 },
{ str: 'hello world' }
)
var objectB = merge(true, objectA,
{ value: 2 }
)
objectA // { value: 1, str: 'hello world' }
objectB // { value: 2, str: 'hello world' }
}
// Recursive merge
{
var objectA = {}
merge.recursive(objectA,
{ level: { value: 1 } },
{ level: { str: 'hello world' } }
)
var objectB = merge.recursive(true, objectA,
{ level: { value: 2 } }
)
objectA.level // { value: 1, str: 'hello world' }
objectB.level // { value: 2, str: 'hello world' }
}
```
# Test
## Node.js
```sh
npm test
```
## Browser
```
./dist/merge.browser.test.html
```
|