AI Extensions for Lodash library

A set of JavaScript utility functions that can be used on their own or as an extension to Lo-Dash.

Dependencies

This module uses a couple of light weight lodash functions minimizing amount of duplicated code when creating distribution files using browserify.

Motivation

To avoid subtle bugs associated with checking for truthy/falsy values we want to use explicit conditional checks. To make the code more readable we want to have inverse of functions to avoid using !. We also want to have a couple of useful type specific value checking functions instead of using ternary operators.

Usage

Install from bower

bower install ai-lodash-extensions
Include 'ai.lodash.extensions.js' or 'ai.lodash.extensions.min.js'  in your HTML file.  
The library exposes 'ai.lodashExtensions' as a global variable.  If you wish you can include 'configureLodashMinimal.js'  in your HTML file to add '_.ai' to host the extension library, or 'configureLodash.js' to also mixin all non-conflicting functions onto lodash (_).

Install from npm

npm install ai-lodash-extensions
Example:
var ai = require('lodashExtensions');
var foo = ai.valueOrDefault(someVariable, () => { return 'foobar'; });

Documentation

hasValue(value)

Checks if value is not null and not undefined and not an empty string. Useful for validating forms.

isDefined(value)

Returns true if value is not undefined, false otherwise.

isEmptyString(value)

Returns true if value is of type string and it is empty.

isNotNullOrUndefined(value)

Returns negation of isNullOrUndefined().

isNullOrUndefined(value)

Returns true if value is either null or undefined

isStringWithValue(value)

Returns true if value is a string of non zero length.

isValueMissing(value)

returns negation of hasValue().

numberOrDefault(value, defaultValue)

Returns value if value is a finite number (not NaN/Infinity/-Infinity) otherwise, it will return a default value unless, defaultValue is a function in which case, it will return the result of calling it.

propertyOrDefault(value, propertyPath, defaultValue)

Returns the value of the property if it not null or undefined otherwise, it will return a default value unless, defaultValue is a function in which case, it will return the result of calling it. Note: propertyPath format is 'dot.delimited.path'.

stringOrDefault(value, defaultValue)

Returns value if value is a non empty string otherwise, it will return a default value unless, defaultValue is a function in which case, it will return the result of calling it.

valueOrDefault(value, defaultValue)

Return value if value is not null or undefined otherwise, it will return a default value unless, defaultValue is a function in which case, it will return the result of calling it.