athea

Repositories Projects Packages

object.assign (4.1.7)

Published 2026-02-24 14:02:02 +00:00 by atheaadmin

Installation

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install object.assign@4.1.7

or add it to the package.json file:

"object.assign": "4.1.7"

For more information on the npm registry, see the documentation.

About this package

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 interface. It works in an ES3-supported environment and complies with the spec. In an ES6 environment, it will also work properly with Symbols.

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:

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

Example

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!

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
});

/* 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));

/* 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

Dependencies

Dependencies

ID	Version
call-bind	^1.0.8
call-bound	^1.0.3
define-properties	^1.2.1
es-object-atoms	^1.0.0
has-symbols	^1.1.0
object-keys	^1.1.1

Development Dependencies

ID	Version
@es-shims/api	^2.5.1
@ljharb/eslint-config	^21.1.1
browserify	^16.5.2
eslint	=8.8.0
for-each	^0.3.3
functions-have-names	^1.2.3
has-strict-mode	^1.0.1
hasown	^2.0.2
mock-property	^1.1.0
npmignore	^0.3.1
nyc	^10.3.2
safe-publish-latest	^2.0.0
ses	^1.10.0
tape	^5.9.0

Keywords

Object.assign assign ES6 extend $.extend jQuery _.extend Underscore es-shim API polyfill shim

Details

npm

2026-02-24 14:02:02 +00:00

0

Jordan Harband

Project Site

MIT

latest

20 KiB

Assets (1)

object.assign-4.1.7.tgz 20 KiB

Versions (1) View all

4.1.7 2026-02-24