object.assign
    Overview
    Documentation
    Tutorials
    Chat
    Insights
    Code
    Dependencies
    Contributors
    Jobs

object.assign

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

4.1.0  •  Updated 2 years ago  •  by Jordan Harband  •  MIT License

#object.assign Version Badge

Build Status dependency status dev dependency status License Downloads

npm badge

browser support

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

Popularity

Maintenance

Development

Last ver 2 years ago
Created 6 years ago
Last commit 5 months ago
8 days between commits

Technology

Node version: 9.3.0
0 unpacked

Compliance

MIT License
OSI Approved
0 vulnerabilities

Contributors

6 contributors
Jordan Harband
Maintainer, 260 commits, 21 merges, 1 PRs
Mathias Bynens
1 commits, 1 PRs
Works at Google
Steven Vachon
1 commits, 2 PRs
Works at Grafana Labs
Jake Champion
1 commits, 1 PRs
Works at Financial Times
zyy
1 commits
greenkeeper[bot]
1 commits

Tags

Object.assign
assign
ES6
extend
$.extend
jQuery
_.extend
Underscore
es-shim API
polyfill
shim
Openbase helps developers choose among and use millions of open-source packages, so they can build amazing products faster.
FacebookTwitterLinkedIn
© 2020 Devstore, Inc.