zshared-server v1.0.0

zshared

Useful javascript/typescript utilities collected over the years. The utilities relate to handling arrays, objects, strings, time, etc. It can be used on browser/node/deno, it has 0 dependencies and is optimized for performance.

Installation

npm install zshared

The library can be consumed by using either 'require' or 'import' syntax. The libraray is devided to classes, each handles its own area (arrays, strings, etc). Each class name begins with 'Z' and the area (ZArray, ZString, etc).

import { ZTime, ZArray } from 'zshared';

Some examples

Below are some examples, the complete list can be found in the docs. All class functions are static.

Time

await ZTime.sleep(1000);  // wait 1 second

get local/utc time in universal format, local time zone GMT+3

ZTime.utcUniDateTime();     // output: 2020-04-29 17:29:20
ZTime.localUniDateTime();   // output: 2020-04-29 20:29:20

convert seconds to display time (hh:mm:ss)

ZTime.seconds2UniTime(3500) // output: 33:20

Objects

const obj1 = { a: 1, b: 2, c: 3 };
ZObj.clone(obj1);  // returns shallow copy { a: 1, b: 2, c: 3 };
ZObj.clone(obj1, ['a', 'c']);  // pass keys array, returns: { a: 1, c: 3 };

ZObj.areEquals(obj1, { a: 1, b: 2 });  // output: false
ZObj.areEquals(obj1, { a: 1, b: 2, c: 3 });  // output: true

Arrays

items = ['a', 'b', 'a', 'c'];
ZArray.distincts(items);  // output: ['a', 'b', 'c'];
ZArray.deleteItem(items, 'b');  // items is now ['a', 'a', 'c'];

items = ['a', 'b', 'c'];
ZArray.toObj(items);  // output: { a: 'a', b: 'b', c: 'c' };
ZArray.toObj(items, item => '_' + item);  // pass a function, output: { a: '_a', b: '_b', c: '_c' };

convert items array to objects

items = [{ a: 1 }, { b: 2 }]; 
ZArray.toObj(items);  // output: { a: 1, b: 2 };
ZArray.toObj(items, (key, value) => value * 2);  // pass a function, output: { a: 2, b: 4 };

Numbers

ZNumber.thousandsSep(12345);  // output: 12,345 or 12.345, depends on locale

Strings

const str = '2 cats met another cat';
ZString.replaceAll(str, 'cat', 'dog');   // output: '2 dogs met another dog'
ZString.occurrences(str, 'cat');         // output: 2
ZString.initialCapital('good morning');  // output: 'Good morning'

logt

the libraray contains also static function 'logt', it prints to the console the message prefixed by the time

logt('some', 'message', 1000);  // output: 2020-04-29 23:39:12.397 ==> some message 1000