object.assign

compare this package
fund

ES6 spec-compliant Object.assign shim. From https://github.com/es-shims/es6-shim

License
MIT
Deps
6(-)
View dependency graphInspect dependency tree
Install Size
78.3 kB(459.4 kB)
Vulns
0
Published

Get started

$npm install object.assign
$pnpm add object.assign
$yarn add object.assign
$bun add object.assign
$deno add npm:object.assign
$vlt install object.assign
$vp add object.assign
$npm install -D @types/object.assignView @types/object.assign
$pnpm add -D @types/object.assignView @types/object.assign
$yarn add -D @types/object.assignView @types/object.assign
$bun add -d @types/object.assignView @types/object.assign
$deno add -D npm:@types/object.assignView @types/object.assign
$vlt install -D @types/object.assignView @types/object.assign
$vp add -D @types/object.assignView @types/object.assign

You might not need this dependency.

This package can be replaced with Object.assign, or if deep clones are needed, use structuredClone, available since Node 4.0.0.Learn more

Weekly DownloadsAcross all versions

Compatibility

Node.js
>= 0.4

Versions

View all versions
4.1.7
latest

Dependencies (6)

Keywords

Maintainers

Readme

object.assign Version Badge

github actions coverage dependency status dev dependency status License Downloads

npm badge

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