# object.assign

\#object.assign [![Version Badge](http://versionbadg.es/ljharb/object.assign.svg)](https://npmjs.org/package/object.assign)

[![Build Status](https://travis-ci.org/ljharb/object.assign.svg)](https://travis-ci.org/ljharb/object.assign) [![dependency status](https://david-dm.org/ljharb/object.assign.svg?theme=shields.io)](https://david-dm.org/ljharb/object.assign) [![dev dependency status](https://david-dm.org/ljharb/object.assign/dev-status.svg?theme=shields.io)](https://david-dm.org/ljharb/object.assign#info=devDependencies) [![License](http://img.shields.io/npm/l/object.assign.svg)](https://github.com/bgoonz/Learning-Redux/blob/master/repos/examples/real-world/node_modules/object.assign/LICENSE/README.md) [![Downloads](http://img.shields.io/npm/dm/object.assign.svg)](http://npm-stat.com/charts.html?package=object.assign)

[![npm badge](https://nodei.co/npm/object.assign.png?downloads=true\&stars=true)](https://npmjs.org/package/object.assign)

[![browser support](https://ci.testling.com/ljharb/object.assign.png)](https://ci.testling.com/ljharb/object.assign)

An Object.assign shim. Invoke its "shim" method to shim Object.assign if it is unavailable.

This package implements the [es-shim API](https://github.com/es-shims/api) interface. It works in an ES3-supported environment and complies with the [spec](http://www.ecma-international.org/ecma-262/6.0/#sec-object.assign). In an ES6 environment, it will also work properly with `Symbol`s.

Takes a minimum of 2 arguments: `target` and `source`. Takes a variable sized list of source arguments - at least 1, as many as you want. Throws a TypeError if the `target` argument is `null` or `undefined`.

Most common usage:

```js
var assign = require('object.assign').getPolyfill(); // returns native method if compliant
	/* or */
var assign = require('object.assign/polyfill')(); // returns native method if compliant
```

### Example

```js
var assert = require('assert');

// Multiple sources!
var target = { a: true };
var source1 = { b: true };
var source2 = { c: true };
var sourceN = { n: true };

var expected = {
	a: true,
	b: true,
	c: true,
	n: true
};

assign(target, source1, source2, sourceN);
assert.deepEqual(target, expected); // AWESOME!
```

```js
var target = {
	a: true,
	b: true,
	c: true
};
var source1 = {
	c: false,
	d: false
};
var sourceN = {
	e: false
};

var assigned = assign(target, source1, sourceN);
assert.equal(target, assigned); // returns the target object
assert.deepEqual(assigned, {
	a: true,
	b: true,
	c: false,
	d: false,
	e: false
});
```

```js
/* when Object.assign is not present */
delete Object.assign;
var shimmedAssign = require('object.assign').shim();
	/* or */
var shimmedAssign = require('object.assign/shim')();

assert.equal(shimmedAssign, assign);

var target = {
	a: true,
	b: true,
	c: true
};
var source = {
	c: false,
	d: false,
	e: false
};

var assigned = assign(target, source);
assert.deepEqual(Object.assign(target, source), assign(target, source));
```

```js
/* when Object.assign is present */
var shimmedAssign = require('object.assign').shim();
assert.equal(shimmedAssign, Object.assign);

var target = {
	a: true,
	b: true,
	c: true
};
var source = {
	c: false,
	d: false,
	e: false
};

assert.deepEqual(Object.assign(target, source), assign(target, source));
```

### Tests

Simply clone the repo, `npm install`, and run `npm test`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bryan-guner.gitbook.io/my-docs/redux/repos/examples/real-world/node_modules/object.assign.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.