object-assign-defined/readme.md

A simple module that works exactly as Object.assign, but skips assigning undefined values.

# [object-assign-defined](https://www.npmjs.com/package/object-assign-defined)

[![npm](https://img.shields.io/npm/v/object-assign-defined.svg)](https://www.npmjs.com/package/object-assign-defined)
[![License](https://img.shields.io/github/license/zitros/object-assign-defined.svg)](LICENSE)
[![Build Status](https://travis-ci.org/ZitRos/object-assign-defined.svg?branch=master)](https://travis-ci.org/ZitRos/object-assign-defined)

A tiny, fast and [well-tested](https://github.com/ZitRos/object-assign-defined/blob/master/test.js)
JavaScript module that works just like `Object.assign`, but skips assigning `undefined` values.

Usage
-----

Import the module and use it like this:

```javascript
import objectAssignDefined from "object-assign-defined";

const result = objectAssignDefined({
    "I": 1
}, {
    "LIKE": 2
}, {
    "TRAINS": undefined
});

// result is { "I": 1, "LIKE": 2 }
```

Note that `undefined` values in source (first argument) won't be vanished:

```javascript
import objectAssignDefined from "object-assign-defined";

const result = objectAssignDefined({
    "I": undefined
}, {
    "LIKE": 2
}, {
    "TRAINS": 3
});

// result is { "I": undefined, "LIKE": 2, "TRAINS": 3 }
```

But you can simply filter `undefined` values by assigning properties to an empty object, like this:

```javascript
import objectAssignDefined from "object-assign-defined";

const result = objectAssignDefined({}, { "I": undefined });

// result is {}
```

Licence
-------

[MIT](LICENSE) © Nikita Savchenko