var VnDate = require('./date'); /** * Clones a simple value. A simple value is any value that is not an array, * object or function. If non-simple value is passed, the same object reference * is returned. * * @param {*} value The value to be copied * @return {*} The value copy */ function simpleClone(value) { if (value instanceof Date) return value.clone(); return value; } /** * Checks if two simple values are equal using the strict equality operator. For * information about simple values see simpleClone() function. * * @param {*} a Value to compare to * @param {*} b Value to compare with * @return {boolean} %true if they are equal, %false otherwise */ function simpleEquals(a, b) { if (a === b) return true; if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime(); return false; } /** * Calculates differences between two simple key-value objects. * * @param {Object} orgObject Value to compare to * @param {Object} newObject Value to compare with * @return {Object} The differences or %null if there are no differences */ function diff(orgObject, newObject) { var diff = {}; for (var key in orgObject) if (!simpleEquals(orgObject[key], newObject[key])) diff[key] = simpleClone(newObject[key]); for (var key in newObject) if (orgObject[key] === undefined && newObject[key] !== undefined) diff[key] = simpleClone(newObject[key]); if (Object.keys(diff).length > 0) return diff; return null; } /** * Calculates new differences between two simple key-value objects. * * @param {Object} orgObject Value to compare to * @param {Object} newObject Value to compare with * @return {Object} The differences or %null if there are no differences */ function partialDiff(orgObject, newObject) { var diff = {}; for (var key in newObject) if (!simpleEquals(orgObject[key], newObject[key])) diff[key] = simpleClone(newObject[key]); if (Object.keys(diff).length > 0) return diff; return null; } /** * Clones a simple key-value object in wich properties are simple values. For * information about simple values see simpleClone() function. * * @param {*} object The object to be cloned * @return The cloned object */ function kvClone(object) { var copy = {}; for (var key in object) copy[key] = simpleClone(object[key]); return copy; } /** * Checks if two values are equal, it also checks objects. Basic values are * compared using the strict equality operator. * * @param {*} a Value to compare to * @param {*} b Value to compare with * @return {boolean} %true if they are equal, %false otherwise */ function equals(a, b) { if (a === b) return true; if (a instanceof Date && b instanceof Date) return a.getTime() === b.getTime(); if (a && b && (typeof a === 'object') && (typeof b === 'object')) { for (var key in a) if (!equals(a[key], b[key])) return false; for (var key in b) if (a[key] === undefined && b[key] !== undefined) return false; return true; } return false; } /** * Returns a formated string. * * @param {Object} formatString The base string template * @param {...} arguments Format parameters * @return {string} The formated string */ function sprintf(formatString) { var args = arguments; if (args.length <= 1) return formatString; var i = 1; return formatString.replace(/%[s|d]/g, function() { return args[i++]; }); } function format(value, format) { if (value === null || value === undefined) return ''; if (format) switch (typeof value) { case 'number': return format.replace(/%\.([0-9]+)d/g, (_, digits) => new Number(value).toFixed(parseInt(digits))); case 'string': return format.replace(/%s/g, () => value); case 'object': if (value instanceof Date) return VnDate.strftime(value, format); } return value; } module.exports = { equals, diff, partialDiff, kvClone, simpleClone, simpleEquals, sprintf, format, };