@openinf/util-object v2.0.1

The high-level goal of @openinf/util-object is to serve as a Node.js package containing utilities for common JavaScript Object type-related utilities primarily enabling users to perform comparisons and analyze object contents. As is the case with any software project in continuous development, omissions and errors may exist, for which contributions are welcome.

Installation

@openinf/util-object runs on Node.js and is available via npm.

npm install @openinf/util-object

Usage

import { hasOwn } from '@openinf/util-object';

export class GhFileImporter {
  constructor(options: GhFileImporterOptions) {
    if (!hasOwn(options, 'destDir')) {
      throw new MissingOptionError('destDir');
    }
  }
}

Functions

map(opt_initial) ⇒ T

Returns a map-like object. If opt_initial is provided, copies its own properties into the newly created object.

Kind: global function

hasOwn(obj, key) ⇒ boolean

Checks if the given key is a property in the map.

Kind: global function

ownProperty(obj, key) ⇒ unknown

Returns objkey iff key is obj's own property (is not inherited). Otherwise, returns undefined.

Kind: global function

deepMerge(target, source, depth) ⇒ Object

Deep merges source into target.

Kind: global function
Throws:

• Error If source contains a circular reference. Note: Only nested objects are deep-merged, primitives and arrays are not.

deepMerge~queue : Array.<ITargetSourceDepth>

Kind: inner constant of deepMerge

omit(o, props) ⇒ Record.<string, (number|RegExp)>

Kind: global function
Returns: Record.<string, (number|RegExp)> - An object with the given properties removed.

objectsEqualShallow(o1, o2) ⇒ boolean

Kind: global function

memo(obj, prop, factory) ⇒ R

Takes an object, a property name, and a factory function. If the value of the property is undefined, it generates a value with the factory function, updates the object originally passed, and returns the value that was returned by the factory function.

Kind: global function