EMS Node Application Components: Utility Methods

Utility methods that are intended for use in NodeJS applications developed by Educational Media Solutions.

These utility methods act like globally scoped functions (though they're not really).

Note that there is a peer dependency defined for this library that must also be installed (underscore.js)

Usage

npm i underscore ems-node-app-utils --save

Module Usage:

import { trace, delay } from "ems-node-app-utils";

Methods

$3

Can be used as the callback argument to Array.sort

(["e","a","c", "d", "b"]).sort(alphabetize); // ["a", "b", "c", "d", "e"]

Also can be used to alphabetize array of objects using key (note: this method mutates original array)

alphabetize([{"label": "b"}, { "label": "a" }], "label"); //[{ "label": "a" }, {"label": "b"}]

$3

Creates a deep copy of the supplied object. References are not maintained. Recursion not supported.

const copy = clone({hello: [{ nested: "object", params: [1,2,3] }]}); //{hello: [{ nested: "object", params: [1,2,3] }]}

$3

Returns a hash of date properties as strings (for formatting)

const dateinfo = dateStrings(new Date("2021/01/01")); { year: "2021", "month": "01", "date": "01", "time": "00:00", "seconds": "00" }

$3

Alias for setTimeout

delay(() => console.log("test")); // same as setTimeout(() => console.log("test"), 0);
delay(() => console.log("test"),100); // same as setTimeout(() => console.log("test"), 100);

$3

alias for falsy

$3

Returns an array of keys in an enum typescript object

enum Grade {
K = "K",
Grade1 = "1",
Grade2 = "2",
Grade3 = "3",
Grade4 = "4",
Grade5 = "5"
}

const keys = enumKeys(Grade); // ["K", "Grade1", "Grade2", "Grade3", "Grade4", "Grade5"];

$3

Returns an array of values in an enum typescript object

enum Grade {
K = "K",
Grade1 = "1",
Grade2 = "2",
Grade3 = "3",
Grade4 = "4",
Grade5 = "5"
}

const values = enumValues(Grade); // ["K", "1", "2", "3", "4", "5"];

$3

Evaluates whether supplied object is falsy or empty.

const obj = {}; falsy(obj); //true
const obj = {hello: "world"}; falsy(obj); //false
const arr = []; falsy(arr); //true
const arr = [1,2,3]; falsy(arr); //false
const str = ""; falsy(str); //true
const str = " "; falsy(str); //true
const str = "hello"; falsy(str); //false
const bool = false; falsy(bool); //true
const bool = true; falsy(bool); //false
const boolString = "False"; falsy(boolString); //true
const boolString = "false"; falsy(boolString); //true
const boolString = "FalSe"; falsy(boolString); //true
const boolString = "true"; falsy(boolString); //false
const num = 0; falsy(num); //true
const num = -1; falsy(num); //false
const num = 1; falsy(num); //false

$3

Handles rounding errors when calculating sub percentages of a data set. Ensures that all segments add up to 100%.

getLargestRemainder([24, 25, 50]); // [25,25,50]

$3

alias for truthy

$3

Converts string to kebab case

kebab("Hello Big_World 2022-01-01"); // "hello-big-world-2022-01-01"

$3

Swaps an item in an array with a newer value

const array = [ { id: 1, name: "Old Name" }, { id: 2, name: "Test User" }];
replaceItem(array, {id: 1, name: "New Name"}); // [ { id: 1, name: "New Name" }, { id: 2, name: "Test User" }]

const array2 = [ { id: 1, name: "Old Name" }, { id: 2, name: "Test User" }];
replaceItem(array, { id: 200, name: "Test User" }, "name"); // [ { id: 1, name: "Old Name" }, { id: 200, name: "Test User" }]

$3

A combination of tick and delay called with an async function to pause the execution for the provided number of milliseconds.

async function doSomething() {
$(".element-to-transition-out.render").removeClass("render");
await sleep(250)
$(".element-to-transition-out").hide();
$(".element-to-transition-in").show();
await sleep(0);
$(".element-to-transition-in").addClass("render");
await sleep(250);
console.log("transition complete!");
}

$3

Converts string to snake case

snakecase("Hello Big-World 2022-01-01"); // "hello_big_world_2022_01_01"

$3

Awaits one turn of the JS engine

async function test() {
$(".torender").css("display","block").addClass("transparent"); //renders the object on screen with 0 opactiy
await tick(); // browser tick paints the above state
$(".torender").removeClass("transparent); //animates opacity to 1 to fade in object
}

$3

Returns MySQL date/time string from optionally supplied date

const date = new Date("2021/01/01");
const dateString = timestamp(date); // "2021-01-01 00:00:00";
const dateString2 = timestamp(date, false); // "2021-01-01";
const nowDateString = timestamp(); // whatever the current date time is

$3

Outputs each argument to a line in console log IF ?debug=true parameter is set on the url
(This method is an homage to the like-named, late great ActionScript 2 utility function)

trace(someObject, anotherObject, "---", 123); //four console logs at http://localhost/?debug=true

$3

Removes leading and trailing whitespace from string

trim(" hello "); // "hello"

$3

Evaluates whether supplied object is truthy or populated

const obj = {}; truthy(obj); //false
const obj = {hello: "world"}; truthy(obj); //true
const arr = []; truthy(arr); //false
const arr = [1,2,3]; truthy(arr); //true
const str = ""; truthy(str); //false
const str = " "; truthy(str); //false
const str = "hello"; truthy(str); //true
const bool = false; truthy(bool); //false
const bool = true; truthy(bool); //true
const boolString = "False"; truthy(boolString); //false
const boolString = "false"; truthy(boolString); //false
const boolString = "FalSe"; truthy(boolString); //false
const boolString = "true"; truthy(boolString); //true
const num = 0; truthy(num); //false
const num = -1; truthy(num); //true
const num = 1; truthy(num); //true

$3

Applies regex to test for valid email

validateEmail("test@test"); //false
validateEmail("test@test.co"); //true

Uses regex ex:

/^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/