handy-utils

Handy utils offers developers a powerful and easy-to-use toolset. With its clean, modular and scalable code structure, it accelerates development processes and reduces code complexity. With a wide range of functions, it offers ready-made methods for solving common problems.

## Installation

NPM

npm install @ahmetilhn/handy-utils

YARN

yarn add @ahmetilhn/handy-utils

Awesome Utils

deepClone

Clone data from any data (disconnect any data binding)

Function Signature

deepClone(val: any): typeof val

Examples

const clonedVal = deepClone({ name: "test" });
expect(clonedVal).not.toBe({ name: "test" }); // reference equal
expect(clonedVal).toEqual(clonedVal); // soft equal

sleep

Wait for the execution process as long as you want

Function Signature

sleep(time: number): Promise<void>

isServer

Function Signature

// it should return true on node runtime
isServer(); // true

isClient

Function Signature

// it should return true on browser
isClient(); // true

Examples

const jobEverySecond = async () => {
  // Codes
  await sleep(1000); // sleep for 1 second
};

Compare

isDeepEqual

Checks the equality of two values.

Function Signature

isDeepEqual(valOne: any, valTwo: any): boolean

Examples

isDeepEqual(10, 10); // true

isDeepEqual("test", 1); // false

isDeepEqual(null, 1); // false

isDeepEqual(null, NaN); // false

isDeepEqual(NaN, NaN); // false

isDeepEqual({ name: "john" }, { name: "john" }); // true

isDeepEqual(["john"], ["john"]); // true

isDeepEqual([{ key: "value" }], [{ key: "value" }]); // true

Type Check

isObject

Check if val is an object

Function Signature

isObject(val: any): boolean

Examples

isObject([]); // true
isObject(null); // false
isObject(undefined); // false
isObject(NaN); // false
isObject({}); //
isObject(new Date()); // true

isDate

Check if val is an date

Function Signature

isDate(val: any): boolean

Examples

isDate(Date); // false
isDate(null); // false
isDate("12-22-2023"); // false
isDate(new Date()); // true

isBoolean

Check if val is true or false (boolean)

Function Signature

isBoolean(val: any): boolean

Examples

isBoolean(null); // false
isBoolean(false); // true
isBoolean(true); // true
isBoolean(Boolean); // false
isBoolean(0); // false

isArray

Check if val is an array

Function Signature

isArray(val: any): boolean

Examples

isArray(null); // false
isArray({}); // false
isArray([]); // true
isArray(new Array([])); // true

isNumber

Check if val is an number

Function Signature

isNumber(val: any): boolean

Examples

isNumber(null); // false
isNumber(NaN); // true
isNumber(1); // true
isNumber("1"); // false

isFunction

Check if val is an function

Function Signature

isFunction(val: any): boolean

Examples

isFunction(NaN); // false
isFunction(() => {}); // true

isUndefined

Check if val isn't defined

Function Signature

isUndefined(val: any): boolean

Examples

const user = {
  name: "John",
};
isUndefined(user.name); // false
isUndefined(user.lastName); // true

isDefined

Check if val is defined

Function Signature

isDefined(val: any): boolean

Examples

const user = {
  name: "John",
};
isDefined(user.name); // true
isDefined(user.lastName); // false

Test Coverage Result

branches: 94 functions: 100 lines: 100 statements: 97

created by Ahmet ilhan