merge-descriptors

merge-descriptors

Merge objects using their property descriptors

Install

npm install merge-descriptors

Usage

import mergeDescriptors from 'merge-descriptors';

const thing = {
	get name() {
		return 'John'
	}
}

const animal = {};

mergeDescriptors(animal, thing);

console.log(animal.name);
//=> 'John'

API

merge(destination, source, overwrite?)

Merges "own" properties from a source to a destination object, including non-enumerable and accessor-defined properties. It retains original values and descriptors, ensuring the destination receives a complete and accurate copy of the source's properties.

Returns the modified destination object.

destination

Type: object

The object to receive properties.

source

Type: object

The object providing properties.

overwrite

Type: boolean
Default: true

A boolean to control overwriting of existing properties.

Similar packages

Other packages similar to merge-descriptors

lodash.merge

Lodash's merge function is similar to merge-descriptors but focuses more on deep merging of properties, including arrays and plain objects. Unlike merge-descriptors, lodash.merge does not handle property descriptors, making it less suitable for cases where property getters, setters, or other descriptor specifics are crucial.

object-assign

The object-assign package provides a function to copy values of all enumerable own properties from one or more source objects to a target object. It is similar to Object.assign() and does not copy property descriptors, making merge-descriptors a better choice when descriptors need to be preserved.