diff --git a/src/util.js b/src/util.js index 14c683218..d68c20e5c 100644 --- a/src/util.js +++ b/src/util.js @@ -1,4 +1,8 @@ "use strict"; +// Common Util for frontend and backend +// Backend uses the compiled file util.js +// Frontend uses util.ts +// Need to run "tsc" to compile if there are any changes. Object.defineProperty(exports, "__esModule", { value: true }); exports.getRandomInt = exports.getRandomArbitrary = exports.TimeLogger = exports.polyfill = exports.debug = exports.ucfirst = exports.sleep = exports.flipStatus = exports.PENDING = exports.UP = exports.DOWN = exports.appName = exports.isDev = void 0; const _dayjs = require("dayjs"); @@ -22,6 +26,10 @@ function sleep(ms) { return new Promise(resolve => setTimeout(resolve, ms)); } exports.sleep = sleep; +/** + * PHP's ucfirst + * @param str + */ function ucfirst(str) { if (!str) { return str; @@ -37,11 +45,19 @@ function debug(msg) { } exports.debug = debug; function polyfill() { + /** + * String.prototype.replaceAll() polyfill + * https://gomakethings.com/how-to-replace-a-section-of-a-string-with-another-one-with-vanilla-js/ + * @author Chris Ferdinandi + * @license MIT + */ if (!String.prototype.replaceAll) { String.prototype.replaceAll = function (str, newStr) { + // If a regex pattern if (Object.prototype.toString.call(str).toLowerCase() === "[object regexp]") { return this.replace(str, newStr); } + // If a string return this.replace(new RegExp(str, "g"), newStr); }; } @@ -58,10 +74,22 @@ class TimeLogger { } } exports.TimeLogger = TimeLogger; +/** + * Returns a random number between min (inclusive) and max (exclusive) + */ function getRandomArbitrary(min, max) { return Math.random() * (max - min) + min; } exports.getRandomArbitrary = getRandomArbitrary; +/** + * From: https://stackoverflow.com/questions/1527803/generating-random-whole-numbers-in-javascript-in-a-specific-range + * + * Returns a random integer between min (inclusive) and max (inclusive). + * The value is no lower than min (or the next integer greater than min + * if min isn't an integer) and no greater than max (or the next integer + * lower than max if max isn't an integer). + * Using Math.round() will give you a non-uniform distribution! + */ function getRandomInt(min, max) { min = Math.ceil(min); max = Math.floor(max); diff --git a/src/util.ts b/src/util.ts index 3b96f7b94..dafa7d3f4 100644 --- a/src/util.ts +++ b/src/util.ts @@ -59,7 +59,6 @@ export function polyfill() { */ if (!String.prototype.replaceAll) { String.prototype.replaceAll = function (str: string, newStr: string) { - // If a regex pattern if (Object.prototype.toString.call(str).toLowerCase() === "[object regexp]") { return this.replace(str, newStr); @@ -67,7 +66,6 @@ export function polyfill() { // If a string return this.replace(new RegExp(str, "g"), newStr); - }; } } diff --git a/tsconfig.json b/tsconfig.json index 41db8c524..b7637c3c9 100644 --- a/tsconfig.json +++ b/tsconfig.json @@ -7,7 +7,7 @@ "es2020", "DOM", ], - "removeComments": true, + "removeComments": false, "preserveConstEnums": true, "sourceMap": false, "strict": true