objectUtils
A utility library for working with JavaScript objects.
Install
objectUtils is an ES6 module. Consequently, you'll need an ES6 transpiler (Babel is a nice one) as part of your Javascript workflow.
If you're already using NPM for your project, you can install objectUtils with the following command:
$ npm install @degjs/object-utils
Usage
Importing individual objectUtils methods:
import { ensureArray } from "@degjs/object-utils";
let guaranteedArray = ensureArray(possibleArray);Importing all objectUtils methods:
import * as objectUtils from "@degjs/object-utils";
let guaranteedArray = objectUtils.ensureArray(possibleArray);Methods
ensureArray(obj)
The ensureArray method returns a guaranteed array, regardless of the paramater passed into it.
obj
Type: Array or String
The potential array to test.
assignDeep(target, source)
The assignDeep method copies the values of a source object to a target object. Unlike Object.assign, assignDeep does a proper deep clone of nested objects.
target
Type: Object
The source object to copy.
source
Type: Object
The target object to copy to.
Browser Support
objectUtils depends on the following browser APIs:
- isArray: Documentation | Polyfill
To support legacy browsers, you'll need to include polyfills for the above APIs.