best-globals

common global function and constants - i.e. coalesce

language: also available in:

Install

$ npm install best-globals

Main goal

Have handy some common global functions

API

coalesce(a [...,b] [,coalesce.throwError(message)])

Returns the first not null nor undefined parameter.

Use coalesce.throwError(message) for throw an Exception if all parameters are null or undefined.

Use coalesce.throwErrorIfUndefined(message) for throw an Exception if all parameters are undefined.

coalesce is similar to ??, but coalesce with null and undefined returns null, and ?? returns the last. Also coalesce can be used with his auxiliar functions throwError and throwErrorIfUndefined.

var coalesce = require('best-globals').coalesce;

console.log(coalesce(1,2)); // = 1
console.log(coalesce(null,3)); // = 3
console.log(coalesce(null,undefined,false,4)); // = false
console.log(coalesce(null,undefined)); // = null [1]
console.log(coalesce(undefined,null)); // = null
console.log(coalesce(undefined,undefined)); // = undefined
console.log(coalesce(undefined,coalesce.throwErrorIfUndefined('name'))); // = throw an Error [1]

Note [1] the behavior differs from ??

changing(originalConfig, changes, options)

Returns a new object like originalConfig with the changes reflected

Changes can be:

• any value,
• an object to apply the recursive changes (if the original is also an object)
• a call to changes.trueByObject(changes) that means that the change only applies to non falsy values

var changing = require('best-globals').changing;

var newConfig = changing(
    {
        database:'default_db',
        port:3306,
        user:'default_user',
        throwExceptions:true
    },
    {
        database:'develop_db',
        user:'devel_user',
        password:'d3v31_u53r',
        throwExceptions:undefined
    },
    changing.options({deletingValue:undefined})
);

console.log(newConfig);
/*
    {
        database:'develop_db',
        port:3306,
        user:'devel_user',
        password:'d3v31_u53r',
    },
*/

changing(new Error(msg), changes)

If the first argument is an instance of Error, It returns the same object with the changes reflected

var changing = require('best-globals').changing;

try{
  //something
  throw changing(new Error('error in example', {Gravity:'Falls'}));
}catch(err){
  console.log(err.message); // error in example
  consoel.log(err.Gravity); // Falls
}

escapeRegExp(text)

Returns de text that must be passed to RegExp for detects the exact original text.

var escapeRegExp = require('best-globals').escapeRegExp;

console.log(RegExp(escapeRegExp('a|b')).test('a|b')); // true
console.log(RegExp(escapeRegExp('a|b')).test('a')); // false
console.log(RegExp(/a|b/).test('a')); // true

forOrder(text)

Returns a unreadeable text that can be used to order the text in an human way

var forOrder = require('best-globals').forOrder;

console.log(forOrder('code X9')