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.