Composite utilities (immutability, fp helpers)

NOTE: All the functions described in API are curried

• Installation
  • Using npm
  • Using yarn
• Types
• API
  • get
    • Parameters
  • getIn
    • Parameters
  • getKeys
    • Parameters
  • hasIn
    • Parameters
  • hasKey
    • Parameters
  • haveSameProps
    • Parameters
  • is
    • Parameters
  • isEmpty
    • Parameters
  • map
    • Parameters
  • remove
    • Parameters
  • removeIn
    • Parameters
  • set
    • Parameters
  • setIn
    • Parameters
  • shallowCopy
    • Parameters
  • shallowEqual
    • Parameters
  • toUndefinedIfEmpty
    • Parameters
  • updateIn
    • Parameters
• License

$ npm install --save @jumpn/utils-composite

$ yarn add @jumpn/utils-composite

type Composite = Array<*> | Object;

type Key = number | string;

type Path = Array<Key>;

Get property value of given key.

• key Key
• composite Composite

Returns any

Returns value located at the given path or undefined otherwise.

• path Path
• composite Composite

Returns any

Get own enumerable keys.

• composite Composite

Returns Array<Key>

Returns true if value located at given path is deeply equal to the one specified.

• path Path
• value any
• composite Composite

Returns boolean

Returns true if key is included in composite's own enumerable ones, or false otherwise.

• key Key
• composite Composite

Returns boolean

Returns true if both composites have the same props or false otherwise.

• c1 Composite
• c2 Composite

Returns boolean

Returns true if parameter is a Composite or false otherwise

• thing any

Returns true if composite has no own enumerable keys (is empty) or false otherwise

• composite Composite

Returns boolean

Maps values of the given composite using mapper

• mapper function (value: any, key: Key, composite: $Supertype<C>): any
• composite C

Returns $Supertype<C>

Returns a new composite with the result of having removed the property with the given key.

• key Key
• composite Composite

Returns Composite

Returns a new composite with the result of having removed the property located at the given path.

(This does the same as calling updateIn with updater: () => updateIn.remove)

• path Path
• composite Composite

Returns Composite

Returns a new composite with the result of having updated the property with the given key with the specified value.

• key Key
• value any
• composite Composite

Returns Composite

Returns a new composite with the result of having updated the property located at the given path with the specified value.

(This does the same as calling updateIn with updater: () => value)

• path Path
• value any
• composite Composite

Returns Composite

Returns a new composite with the same own enumerable props of the one given.

• composite C

Returns C

Returns true if both composites are of the same type (Array or Object) and their properties are strictly equal.

• c1 Composite
• c2 Composite

Returns boolean

Returns given composite if it has any own enumerable keys (is not empty) or undefined otherwise

• composite Composite

Returns Composite

Returns a new composite with the result of having updated the property value at the given path with the result of the call to updater function.

Entry removal is supported by returning updateIn.remove symbol on updater function.

• path Path
• updater function (prev: any): any
• composite Composite

Returns Composite

MIT ©️ Jumpn Limited / Mauro Titimoli ([email protected])