util.js

/*
 * Licensed under MIT License http://www.opensource.org/licenses/mit-license
 * Module contain additional system functional
 */

(function(scope) {
    'use strict';
    
    var Scope;
    
    if (scope.window) {
        Scope           = window;
        Scope.Util      = new UtilProto();
    } else {
        Scope           = global;
        module.exports  = new UtilProto();
    }
    
    function UtilProto() {
        var Util = this;
        
        this.asyncCall              = function(funcs, callback) {
            var i, element, name, func,
                funcsCount  = funcs.length,
                count       = 0,
                data        = [];
                
            for (i = 0; i < funcsCount; i++) {
                func = funcs[i];
                callCheckFunc(i, func);
            }
            
            function checkFunc(pNum, pData) {
                var i, n    = pData.length,
                    params  = [];
                
                ++count;
                
                if (n >= 2) {
                    for (i = 0; i < n; i++)
                        params[i] = pData[i];
                    
                    data[pNum] = params;
                } else
                    data[pNum] = pData[0];
                
                if (count === funcsCount)
                    Util.retExec(callback).apply(null, data);
            }
            
            function callCheckFunc(num, func) {
                Util.exec(func, function() {
                    checkFunc(num, arguments);
                });
            }
        },
        
        /*
         * bind function to arguments without context
         */
        
        this.bind           =  function(callback) {
            var result,
                args    = Util.slice(arguments, 1),
                bind    = Function.prototype.bind;
            
            args.unshift(null);
            result      = bind.apply(callback, args);
            
            return result;
        };
        
        /**
         * ad new line (if it's not)
         * @param {string} pText
         */
        this.addNewLine             = function(pText) {
            var lNewLine    = '',
                n           = pText && pText.length;
            
            if(n && pText[n-1] !== '\n')
                lNewLine = '\n';
            
            return pText + lNewLine;
        };
        
        /**
         * rm new line (if it's)
         * @param {string} pText
         */
        this.rmNewLine             = function(pText) {
            var strs        = ['\n', '\r'],
                text        = Util.removeStr(pText, strs);
            
            return text;
        };
        
        /**
         * Функция ищет в имени файла расширение
         * и если находит возвращает true
         * @param pName - получает имя файла
         * @param pExt - расширение
         */
        this.checkExtension         = function(pName, pExt) {
            var i, lExtNum, lExtSub,
                lRet        = false,
                lExtLength  = pExt && pExt.length,
                lLength     = pName && pName.length; /* длина имени*/
            
            /* если длина имени больше длинны расширения - имеет смысл продолжать
             */
            if (Util.isString(pExt) && lLength > lExtLength) {
                lExtNum = pName.lastIndexOf(pExt),  /* последнее вхождение расширения*/
                lExtSub = lLength - lExtNum;        /* длина расширения*/
                
                /* если pExt - расширение pName */
                lRet = lExtSub === lExtLength;
            
            } else if (Util.isObject(pExt) && lExtLength)
                for(i = 0; i < pName.length; i++) {
                    lRet = Util.checkExtension(pName, pExt[i]);
                    
                    if (lRet)
                        break;
                }
            
            return lRet;
        };
        
        
        /**
         * Check is Properties exists and they are true if neaded
         * 
         * @param pObj
         * @param pPropArr
         * @param pTrueArr
         */
        this.checkObj               = function(pObj, pPropArr, pTrueArr) {
            var lRet,
                i, n;
            
            if (pObj) {
                lRet = Util.isArray(pPropArr);
                if (lRet) {
                    n = pPropArr.length;
                    for (i = 0; i < n; i++) {
                        var lProp = pPropArr[i];
                        lRet = pObj.hasOwnProperty( lProp );
                        if (!lRet) {
                            console.trace();
                            Util.logError(lProp + '  not in Obj!');
                            Util.log(pObj);
                            break;
                        }
                    }
                }
                
                if (lRet && Util.isArray(pTrueArr))
                    lRet = Util.checkObjTrue(pObj, pTrueArr);
            }
            
            return lRet;
        };
        
        /**
         * Check is Properties exists and they are true 
         * 
         * @param pObj
         * @param pPropArr
         * @param pTrueArr
         */
        this.checkObjTrue           = function(pObj, pTrueArr) {
            var lRet, lTrueArr,
                i, n;
            if (pObj) {
                lTrueArr = Util.isArray(pTrueArr) ? pTrueArr : [pTrueArr];
                
                n = lTrueArr.length;
                for(i = 0; i < n; i++) {
                    var lProp   = lTrueArr[i];
                    lRet        = pObj[lProp];
                    
                    if (!lRet) {
                        console.trace();
                        Util.logError(lProp + '  not true!');
                        Util.log(pObj);
                        break;
                    }
                }
            }
            
            return lRet;
        };
        
        /**
         * Copy properties from from to to
         * 
         * @param from
         * @param to
         */
        this.copyObj                = function(to, from) {
            if (!from) {
                from    = to;
                to      = {};
            }
            
            Util.forIn(from, function(name) {
                to[name]    = from[name];
            });
            
            return to;
        };
        
        this.convertArrToObj        = function(pArrKeys, pArrVal) {
            var i, n, lName, lRet;
            
            if (pArrKeys && pArrVal) {
                for(i = 0, n = pArrKeys; i < n; i++) {
                    lName       = pArrKeys[i];
                    lRet[lName] = pArrVal[i];
                }
            }
            
            return lRet;
        };
        
        /**
         * copy pObj properties to pTargetObject
         * 
         * @pTarget
         * @pObj
         */
        this.extend                 = function(pTarget, PObj) {
            var i, n, lObj, lRet = Util.isObject(pTarget) ? pTarget : {};
            
            if ( Util.isArray(PObj) )
                for(i = 0, n = PObj.length; i < n; i++)
                    lRet = Util.extend(pTarget, PObj[i]);
            
            else if (PObj) {
                lObj = Util.isFunction(PObj)  ? new PObj() : PObj;
                
                for(i in lObj)
                    lRet[i] = lObj[i];
            }
            
            return lRet;
        };
        
        /**
         * copy pObj properties to pTargetObject
         * 
         * @pTarget
         * @pObj
         */
         this.extendProto           = function(pObj) {
            var lRet, F     = function() {};
            F.prototype     = Util.extend({}, pObj);
            lRet = new F();
            
            return lRet;
         };
        
        /** for function
         *  @param pI
         *  @param pN
         *  @param pFunc
         */
        this.for                    = function(pI, pN, pFunc) {
            if (Util.isFunction(pFunc))
                for(var i = pI, n = pN; i < n; i++) {
                    if (pFunc(i))
                        break;
                }
        };
        
         /** for in function
         *  @param pObj
         *  @param pFunc
         */
        this.forIn                    = function(pObj, pFunc) {
            if (Util.isFunction(pFunc))
                for(var lName in pObj)
                    if (pFunc(lName))
                        break;
        };
        
        /** for function with i = 0
         *  @param pN
         *  @param pFunc
         */
        this.fori                   = function(pN, pFunc) {
            var lRet = Util.for(0, pN, pFunc);
            
            return lRet;
        };
        
        /**
         * @param pJSON
         */    
        this.parseJSON               = function(pJSON) {
            var lRet;
            
            Util.tryCatch(function() {
                lRet = JSON.parse(pJSON);
            });
            
            return lRet;
        };
        
        /**
         * @param pObj
         */
        this.stringifyJSON           = function(pObj) {
            var ret;
            
            Util.tryCatchLog(function() {
                ret = JSON.stringify(pObj, null, 4);
            });
            
            return ret;
        };
        
        /**
         * function check is strings are equal
         * @param pStr1
         * @param pStr2
         */
        this.strCmp                 = function(pStr1, pStr2) {
            var i, n,
                lRet = Util.isString(pStr1);
            
            if (lRet)
                if (Util.isArray(pStr2))
                    for (i = 0, n = pStr2.length; i < n; i++) {
                        lRet = Util.strCmp(pStr1, pStr2[i]);
                        
                        if (lRet)
                            break;
                    }
                else if (Util.isString(pStr2))
                    lRet =  Util.isContainStr(pStr1, pStr2) &&
                        pStr1.length === pStr2.length;
            
            return lRet;
            
        };
        
        this.getStrBigFirst         = function(pStr) {
            var lRet;
            
            if (Util.isString(pStr) && pStr.length > 0)
                lRet =  pStr[0].toUpperCase() + 
                        pStr.substring(1);
            else
                lRet = pStr;
            
            return lRet;
        };
        
        /**
         * function returns is pStr1 contains pStr2
         * @param pStr1
         * @param pStr2
         */
         
        this.isContainStr           = function(pStr1, pStr2) {
            var i, n, regExp, str,
                ret     = Util.isString(pStr1);
            
            if (ret)
                if (Util.isArray(pStr2)) {
                     n  = pStr2.length;
                     
                     for(i = 0; i < n; i++) {
                         str    = pStr2[i];
                         ret    = Util.isContainStr(pStr1, str);
                        
                        if (ret)
                            break;
                     }
                } else if (Util.isString(pStr2))
                    ret = pStr1.indexOf(pStr2) >= 0;
            
            return ret;
        };
        
        /**
         * is pStr1 contains pStr2 at begin
         * @param pStr1
         * @param pStr2
         */
        this.isContainStrAtBegin    = function(pStr1, pStr2) {
            var i, n, length, subStr, lRet;
            
            if (Util.isString(pStr1))
                 if (Util.isArray(pStr2)) {
                     n = pStr2.length;
                     
                     for(i = 0; i < n; i++) {
                        lRet = Util.isContainStrAtBegin(pStr1, pStr2[i]);
                        
                        if (lRet)
                            break;
                     }
                 } else {
                    length = pStr2.length,
                    subStr = pStr1.substring(0, length);
                    
                    lRet = subStr === pStr2;
                }
                
            return lRet;
        };
        
        /**
         * function log pArg if it's not empty
         * @param pArg
         */
        this.log                    = function() {
            var args        = this.slice(arguments),
                console     = Scope.console,
                lDate       = '[' + Util.getDate() + '] ';
                
            if (console && args.length && args[0]) {
                args.unshift(lDate);
                
                console.log.apply(console, args);
                
                args.shift();
            }
            
            return args.join(' ');
        };
        
        /**
         * log array of elements
         * @param pArray
         */
        this.logArray               = function(pArray) {
            var i, n;
            
            if (pArray)
                for (i = 0, n = pArray.length; i < n; i++)
                    Util.log( pArray[i] );
            
            return pArray;
        };
        
        /**
         * function log pArg if it's not empty
         * @param pArg
         */
        this.logError               = function(pArg) {
            var lConsole    = Scope.console,
                lDate       = '[' + Util.getDate() + '] ';
            
            if (lConsole && pArg) {
                var lMsg = pArg.message;
                if ( lMsg )
                    lDate += pArg.message + ' ';
                
                lConsole.error(lDate, pArg);
            }
            
            return pArg;
        };
        
        /**
         * load functions thrue callbacks one-by-one
         * @param funcs {Array} - array of functions
         */
        this.loadOnLoad             = function(funcs) {
            var func, callback;
            
            if (Util.isArray(funcs)) {
                func        = funcs.shift();
                
                callback    = function(pData) {
                    return Util.loadOnLoad(funcs);
                };
                
                Util.exec(func, callback);
            }
        };
        
        /**
         * function remove substring from string
         * @param pStr
         * @param pSubStr
         */
        this.removeStr              = function(pStr, pSubStr) {
            var lRet = Util.isString(pStr) && pSubStr;
            
            if ( lRet ) {
                var n = pSubStr.length;
                
                if ( Util.isArray(pSubStr) )
                    Util.fori(n, function(i) {
                        lRet = pStr =  Util.replaceStr(pStr, pSubStr[i], '');
                    });
                else
                    lRet = Util.replaceStr(pStr, pSubStr, '');
            }
            else
                lRet = pStr;
            
            return lRet;
        };
        
          /**
         * function remove substring from string one time
         * @param pStr
         * @param pSubStr
         */
        this.removeStrOneTime            = function(pStr, pSubStr) {
            var lRet = Util.isString(pStr) && pSubStr;
            
            if ( lRet ) {
                var n = pSubStr.length;
                
                if ( Util.isArray(pSubStr) )
                    Util.fori(n, function(i) {
                        lRet = pStr = pStr.replace(pSubStr[i], '');
                    });
                else
                    lRet = pStr.replace(pSubStr, '');
            }
            else
                lRet = pStr;
            
            return lRet;
        };
        
        /**
         * function replase pFrom to pTo in pStr
         * @pStr
         * @pFrom
         * @pTo
         * @pNotEscape
         */
        this.replaceStr             = function(pStr, pFrom, pTo, pNotEscape) {
            var lRet = pStr;
            
            if (pStr && pFrom) {
                if (!pNotEscape)
                    pFrom = Util.escapeRegExp(pFrom);
                
                lRet = pStr.replace(new RegExp(pFrom, 'g'), pTo);
            }
           
           return lRet;
        };
        
        
        this.escapeRegExp = function(pStr) {
            var lRet    = pStr,
                isStr   = Util.isString(pStr);
            
            if (isStr)
                lRet = pStr.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
            
            return lRet;
        };
        
        /**
         * function render template with view
         * @pTempl
         * @pView
         */
        this.render                  = function(pTempl, pView) {
            var lRet = Util.ownRender(pTempl, pView);
                    
            return lRet;
        };
        
        /**
         * function render template with view and own symbols
         * @pTempl
         * @pView
         * @pSymbols
         */
        this.ownRender                  = function(pTempl, pView, pSymbols) {
            var SPACES  = '\\s*';
            
            if (!pSymbols)
                pSymbols = ['{{' + SPACES, SPACES + '}}'];
            
            var lRet    = pTempl,
                lFirstChar,
                lSecondChar;
                
                lFirstChar  = pSymbols[0];
                lSecondChar = pSymbols[1]  || lFirstChar;
            
            for(var lVar in pView) {
                var lStr = pView[lVar];
                lStr = Util.exec(lStr) || lStr;
                
                lRet = Util.replaceStr(lRet, lFirstChar + lVar + lSecondChar, lStr, true);
            }
            
            return lRet;
        };
        
        
        /**
         * invoke a couple of functions in paralel
         * 
         * @param {Array} pFuncs
         * @param {function} pCallback
         * 
         * Example:
         * i >=0, pFuncs[i] = function(param, callback) {}
         */
        this.paralelExec            = function(pFuncs, pCallback) {
            var done = [];
            
            /* add items to array done*/
            function addFunc(pNum) {
                done.push(pNum);
            }
            
            /* 
             * improve callback of funcs so
             * we pop number of function and
             * if it's last we call pCallBack
             */
            function doneFunc(pParams) {
                Util.exec(pParams.callback);
                
                var lNum = done.pop (pParams.number);
                if (!lNum) {
                    Util.exec(pCallback);
                }
            }
            
            for(var i = 0, n = pFuncs.length; i < n; i++) {
                addFunc(i);
                
                var lFunc = pFuncs[i].callback;
                
                pFuncs[i].callback = Util.retExec(doneFunc, {
                    number      : i,
                    callback    : lFunc
                });
            }
        };
        
        /**
         * functions check is pVarible is array
         * @param pVarible
         */
        this.isArray                = function(pVarible) {
            return pVarible instanceof Array;
        };
        
        /**
         * functions check is pVarible is ArrayBuffer
         * @param pVarible
         */
        this.isArrayBuffer          = function(pVarible) {
            return pVarible instanceof ArrayBuffer;
        };
        
        /**
         * functions check is pVarible is boolean
         * @param pVarible
         */
        this.isBoolean               = function(pVarible) {
            return Util.isType(pVarible, 'boolean');
        };
        
        /**
         * functions check is pVarible is function
         * @param pVarible
         */
        this.isFunction             = function(pVarible) {
            return Util.isType(pVarible, 'function');
        };
        
        /**
         * functions check is pVarible is number
         * @param pVarible
         */
        this.isNumber               = function(pVarible) {
            return Util.isType(pVarible, 'number');
        };
        
        /**
         * functions check is pVarible is object
         * @param pVarible
         */
        this.isObject               = function(pVarible) {
            return Util.isType(pVarible, 'object');
        };
        
        /**
         * functions check is pVarible is string
         * @param pVarible
         */
         this.isString               = function(pVarible) {
            return Util.isType(pVarible, 'string');
        };
        
        /**
         * functions check is pVarible is string
         * @param pVarible
         */
         this.isUndefined           = function(pVarible) {
            return Util.isType(pVarible, 'undefined');
        };
        
        /**
         * functions check is pVarible is pType
         * @param pVarible
         * @param pType
         */    
        this.isType                 = function(pVarible, pType) {
            return typeof pVarible === pType;
        };
        
        
       /**
         * return save exec function
         * @param callback
         */
        this.retExec                = function() {
            var result,
                exec    = Util.exec.bind(Util),
                args    = Util.slice(arguments);
            
            args.unshift(exec);
            result      = Util.bind.apply(null, args);
            
            return result;
        };
        
        /**
         * function return false
         */
        this.retFalse               = function() {
            var lRet = false;
            
            return lRet;
        };
        
        /**
         * function return param
         */
        this.retParam               = function(pParam) {
            return pParam;
        };
        
        /**
         * return load functions thrue callbacks one-by-one
         * @param pFunc_a {Array} - array of functions
         * @param pData - not necessarily
         */
        this.retLoadOnLoad             = function(pFunc_a, pData) {
            return function() {
                Util.loadOnLoad(pFunc_a, pData);
            };
        };
        
        /**
         * function makes new array based on first
         * 
         * @param array
         */
        this.slice                  = function(array, count) {
            var ret;
            
            if (array)
                ret = [].slice.call(array, count);
            
            return ret;
        };
        
        /**
         * function execute param function in
         * try...catch block
         * 
         * @param pCallBack
         */
        this.tryCatch               = function(pCallBack) {
            var lRet;
            try{
                lRet = pCallBack();
            }
            catch(pError) {
                lRet = pError;
            }
            
            return lRet;
        };
        
        /**
         * function execute param function in
         * try...catch block and log result
         * 
         * @param pTryFunc
         */
        this.tryCatchDebug          = function(pTryFunc) {
            var lRet = Util.tryCatch(pTryFunc);
            
            if (lRet)
                Util.debug();
            
            return lRet;
        };
        
        /**
         * function execute param function in
         * try...catch block and log result
         * 
         * @param pTryFunc
         */
        this.tryCatchLog                = function(pTryFunc) {
            var lRet;
            
            lRet = Util.tryCatch(pTryFunc);
            
            return Util.logError(lRet);
        };
        
        /**
         * function execute param function in
         * try...catch block and log result
         * 
         * @param pCallBack
         */
        this.tryCatchCall               = function(pTryFunc, pCallBack) {
            var lRet;
            
            lRet = Util.tryCatch(pTryFunc);
            
            if (lRet)
                Util.exec(pCallBack, lRet);
            
            return lRet;
        };
        
        /**
         * function do save exec of function
         * @param pCallBack
         * @param pArg1
         * ...
         * @param pArgN
         */
        this.exec                       = function(callback) {
            var ret,
                args    = Util.slice(arguments, 1);
           
            if (Util.isFunction(callback))
            ret         = callback.apply(null, args);
            
            return ret;
        };
        
        /**
         * exec function if it exist in object
         * @pArg
         */
        this.execIfExist                = function(pObj, pName, pArg) {
            var ret, bind,
                func    = pObj && pObj[pName];
            
            if (func) {
                func    = func.bind(pObj);
                ret     = Util.exec(func, pArg);
            }
            
            return ret;
        };
        
        /**
         * function do conditional save exec of function
         * @param pCondition
         * @param pCallBack
         * @param pFunc
         */
        this.ifExec                       = function(pCondition, pCallBack, pFunc) {
            var lRet;
            
            if (pCondition)
                Util.exec(pCallBack, pCondition);
            else
                Util.exec(pFunc, pCallBack);
            
            return lRet;
        };
        
        /**
         * function gets file extension
         * @param pFileName
         * @return Ext
         */
        this.getExtension               = function(pFileName) {
            var lRet, lDot;
            
            if ( Util.isString(pFileName) ) {
                lDot = pFileName.lastIndexOf('.');
                lRet = pFileName.substr(lDot);
            }
            
            return lRet;
        };
        
       /**
         * get values from Object Array name properties
         * or 
         * @pObj
         */
        this.getNamesFromObjArray       = function(pArr) {
            var lRet = [];
            
            if (pArr && !Util.isArray(pArr))
                pArr = pArr.data;
            
            if (pArr)
                Util.fori(pArr.length, function(i) {
                    lRet[i] = pArr[i].name || pArr[i];
                });
            
            return lRet;
        };
        
        /**
         * find object by name in arrray
         * or 
         * @pObj
         */
        this.findObjByNameInArr         = function(pArr, pObjName) {
            var lRet;
            
            if (pArr) {
                for(var i = 0, n = pArr.length; i < n; i++ )
                    if (pArr[i].name === pObjName) break;
                
                lRet = pArr[i].data;
            }
            
            return lRet;
        };
        
        /** 
         * Gets current time in format hh:mm:ss
         */
        this.getTime                    = function() {
            var lRet,
                date        = new Date(),
                hours       = date.getHours(),
                minutes     = date.getMinutes(),
                seconds     = date.getSeconds();
                
            minutes         = minutes < 10 ? '0' + minutes : minutes;
            seconds         = seconds < 10 ? '0' + seconds : seconds;
            
            lRet            = hours + ":" + minutes + ":" + seconds;
            
            return lRet;
        };
        
        
        /**
         * start timer
         * @pArg
         */
        this.time                       = function(pArg) {
            var lRet,
                lConsole    = Scope.console;
            
            lRet = Util.execIfExist(lConsole, 'time', pArg);
            
            return lRet;
        };
        
        /**
         * stop timer
         * @pArg
         */
        this.timeEnd                   = function(pArg) {
            var lRet,
                lConsole    = Scope.console;
            
            lRet = Util.execIfExist(lConsole, 'timeEnd', pArg);
            
            return lRet;
        };
        
        /** 
         * Gets current date in format yy.mm.dd hh:mm:ss
         */
        this.getDate                    = function() {
            var date    = new Date(),
                day     = date.getDate(),
                month   = date.getMonth() + 1,
                year    = date.getFullYear(),
                lRet    = year + "-" + month + "-" + day + " " + Util.getTime();
            
            return lRet;
        };
    }
    
})(this);