devextreme
Version:
HTML5 JavaScript Component Suite for Responsive Web Development
283 lines (282 loc) • 8.93 kB
JavaScript
/**
* DevExtreme (esm/core/utils/common.js)
* Version: 21.1.4
* Build date: Mon Jun 21 2021
*
* Copyright (c) 2012 - 2021 Developer Express Inc. ALL RIGHTS RESERVED
* Read about DevExtreme licensing here: https://js.devexpress.com/Licensing/
*/
import config from "../config";
import Guid from "../guid";
import {
when,
Deferred
} from "../utils/deferred";
import {
toComparable
} from "./data";
import {
each
} from "./iterator";
import {
isDefined,
isFunction,
isString,
isObject,
type
} from "./type";
export var ensureDefined = function(value, defaultValue) {
return isDefined(value) ? value : defaultValue
};
export var executeAsync = function(action, context) {
var deferred = new Deferred;
var normalizedContext = context || this;
var task = {
promise: deferred.promise(),
abort: function() {
clearTimeout(timerId);
deferred.rejectWith(normalizedContext)
}
};
var callback = function() {
var result = action.call(normalizedContext);
if (result && result.done && isFunction(result.done)) {
result.done((function() {
deferred.resolveWith(normalizedContext)
}))
} else {
deferred.resolveWith(normalizedContext)
}
};
var timerId = (arguments[2] || setTimeout)(callback, "number" === typeof context ? context : 0);
return task
};
var delayedFuncs = [];
var delayedNames = [];
var delayedDeferreds = [];
var executingName;
var deferExecute = function(name, func, deferred) {
if (executingName && executingName !== name) {
delayedFuncs.push(func);
delayedNames.push(name);
deferred = deferred || new Deferred;
delayedDeferreds.push(deferred);
return deferred
} else {
var oldExecutingName = executingName;
var currentDelayedCount = delayedDeferreds.length;
executingName = name;
var result = func();
if (!result) {
if (delayedDeferreds.length > currentDelayedCount) {
result = when.apply(this, delayedDeferreds.slice(currentDelayedCount))
} else if (deferred) {
deferred.resolve()
}
}
executingName = oldExecutingName;
if (deferred && result && result.done) {
result.done(deferred.resolve).fail(deferred.reject)
}
if (!executingName && delayedFuncs.length) {
("render" === delayedNames.shift() ? deferRender : deferUpdate)(delayedFuncs.shift(), delayedDeferreds.shift())
}
return result || when()
}
};
export var deferRender = function(func, deferred) {
return deferExecute("render", func, deferred)
};
export var deferUpdate = function(func, deferred) {
return deferExecute("update", func, deferred)
};
export var deferRenderer = function(func) {
return function() {
var that = this;
return deferExecute("render", (function() {
return func.call(that)
}))
}
};
export var deferUpdater = function(func) {
return function() {
var that = this;
return deferExecute("update", (function() {
return func.call(that)
}))
}
};
export var findBestMatches = function(targetFilter, items, mapFn) {
var bestMatches = [];
var maxMatchCount = 0;
each(items, (index, itemSrc) => {
var matchCount = 0;
var item = mapFn ? mapFn(itemSrc) : itemSrc;
each(targetFilter, (paramName, targetValue) => {
var value = item[paramName];
if (void 0 === value) {
return
}
if (match(value, targetValue)) {
matchCount++;
return
}
matchCount = -1;
return false
});
if (matchCount < maxMatchCount) {
return
}
if (matchCount > maxMatchCount) {
bestMatches.length = 0;
maxMatchCount = matchCount
}
bestMatches.push(itemSrc)
});
return bestMatches
};
var match = function(value, targetValue) {
if (Array.isArray(value) && Array.isArray(targetValue)) {
var mismatch = false;
each(value, (index, valueItem) => {
if (valueItem !== targetValue[index]) {
mismatch = true;
return false
}
});
if (mismatch) {
return false
}
return true
}
if (value === targetValue) {
return true
}
return false
};
export var splitPair = function(raw) {
var _raw$x, _raw$y;
switch (type(raw)) {
case "string":
return raw.split(/\s+/, 2);
case "object":
return [null !== (_raw$x = raw.x) && void 0 !== _raw$x ? _raw$x : raw.h, null !== (_raw$y = raw.y) && void 0 !== _raw$y ? _raw$y : raw.v];
case "number":
return [raw];
case "array":
return raw;
default:
return null
}
};
export var normalizeKey = function(id) {
var key = isString(id) ? id : id.toString();
var arr = key.match(/[^a-zA-Z0-9_]/g);
arr && each(arr, (_, sign) => {
key = key.replace(sign, "__" + sign.charCodeAt() + "__")
});
return key
};
export var denormalizeKey = function(key) {
var arr = key.match(/__\d+__/g);
arr && arr.forEach(char => {
var charCode = parseInt(char.replace("__", ""));
key = key.replace(char, String.fromCharCode(charCode))
});
return key
};
export var pairToObject = function(raw, preventRound) {
var pair = splitPair(raw);
var h = preventRound ? parseFloat(pair && pair[0]) : parseInt(pair && pair[0], 10);
var v = preventRound ? parseFloat(pair && pair[1]) : parseInt(pair && pair[1], 10);
if (!isFinite(h)) {
h = 0
}
if (!isFinite(v)) {
v = h
}
return {
h: h,
v: v
}
};
export var getKeyHash = function(key) {
if (key instanceof Guid) {
return key.toString()
} else if (isObject(key) || Array.isArray(key)) {
try {
var keyHash = JSON.stringify(key);
return "{}" === keyHash ? key : keyHash
} catch (e) {
return key
}
}
return key
};
export var escapeRegExp = function(string) {
return string.replace(/[[\]{}\-()*+?.\\^$|\s]/g, "\\$&")
};
export var applyServerDecimalSeparator = function(value) {
var separator = config().serverDecimalSeparator;
if (isDefined(value)) {
value = value.toString().replace(".", separator)
}
return value
};
export var noop = function() {};
export var asyncNoop = function() {
return (new Deferred).resolve().promise()
};
export var grep = function(elements, checkFunction, invert) {
var result = [];
var check;
var expectedCheck = !invert;
for (var i = 0; i < elements.length; i++) {
check = !!checkFunction(elements[i], i);
if (check === expectedCheck) {
result.push(elements[i])
}
}
return result
};
var arraysEqualByValue = function(array1, array2, depth) {
if (array1.length !== array2.length) {
return false
}
for (var i = 0; i < array1.length; i++) {
if (!equalByValue(array1[i], array2[i], depth + 1)) {
return false
}
}
return true
};
var objectsEqualByValue = function(object1, object2, depth, strict) {
for (var propertyName in object1) {
if (Object.prototype.hasOwnProperty.call(object1, propertyName) && !equalByValue(object1[propertyName], object2[propertyName], depth + 1, strict)) {
return false
}
}
for (var _propertyName in object2) {
if (!(_propertyName in object1)) {
return false
}
}
return true
};
var maxEqualityDepth = 3;
export var equalByValue = function(object1, object2) {
var depth = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : 0;
var strict = arguments.length > 3 && void 0 !== arguments[3] ? arguments[3] : true;
object1 = toComparable(object1, true);
object2 = toComparable(object2, true);
var comparisonResult = strict ? object1 === object2 : object1 == object2;
if (comparisonResult || depth >= maxEqualityDepth) {
return true
}
if (isObject(object1) && isObject(object2)) {
return objectsEqualByValue(object1, object2, depth, strict)
} else if (Array.isArray(object1) && Array.isArray(object2)) {
return arraysEqualByValue(object1, object2, depth)
}
return false
};