js-helpertools v1.5.0

js-helpertools

A npm package which can be useful while building a node application. It contains some minor and major functions which developers often search for on google or stackoverflow.

For Example

• A Function to generate a random key
• A Function to deeply sort an array
• A Function to get one or more random element/s from an array
• A Function to encrypt/decrypt a text

Github Repository

How To Use

Install js-helpertools with npm

  npm install js-helpertools

Basic Example

 let Tools = require("js-helpertools");

 let randomKey = Tools.generateKey(16);
 //result : 5YzDqOfcT30EEqrr 

List Of Functions

• Generate a key

 Tools.generateKey(length,includeSC);
 // returns a string

• Get a random number within a limit

  Tools.random(300);
  // returns a number ebtween 0 - 300

• Get a random element from an array

 let array = [23,45,87,90];
 Tools.sampleOne(array);
 // returns 87

• Get 2 or more random elements from an array

 let array = [23,45,87,90];
 Tools.sampleMany(array,2);
 // returns [45,90]

• Check accuracy. Useful during building games

 Tools.isLucky(60);
 // returns true or false

• Deeply shuffles an array

 Tools.shuffle(array);
 // returns a shuffled array

• Compares two arrays.

 Tools.compareArrays(array1,array2);
 // returns true if elements of both arrays are same and in same order.

• Removes the element of given index in array and returns new array

 Tools.removeElement(array,index);
 // returns updated array

• Removes all characters,spaces, whitespaces from string and returns a lower case alphanumeric string.

 Tools.toId("Hello Guys!~ Sup?? 123!!!");
 // returns "helloguyssup123"

• Returns "1st, 2nd... nth" type string. depends on the number order

 Tools.toNumberOrderString(21);
 // returns "21st"

• Escapes HTML characters

 Tools.escapeHTML(html);
 // returns escaped HTML

• Unescapes HTML characters

 Tools.unescapeHTML(html);
 // returns unescaped HTML

• Takes Date object and returns a time stamp string. example "2022-04-11 22:55:45"

 Tools.toTimestampString(date);
 // returns "2022-04-11 22:55:45"

• Takes Date object and returns a duration string. example '52 years, 3 months, 10 days, 17 hours, 28 minutes, and 37 seconds'

 Tools.toDurationString(date)
 // returns a duration string

• Returns all the possible permutations of given array elements

 Tools.getPermutations(elements,min,max);
 // returns an array

• Returns all the possible combinations of given arrays elements

 Tools.getCombinations(arr1,arr2,...,arrn);
 // returns an array

• Calculate the execution time of a function

 Tools.getRunTime(func,arg1,arg2);
 // returns the execution time in milliseconds

• Deeply clone an object

 Tools.deepClone(obj);
 // returns an object

Contributing

Contributions are always welcome!

You can help us add more functions that can be useful for developers. Visit this project's Github Repository and start a PR.

While adding more functions to this package try to -

• Not include any dependancy unless it's necessary
• Make a clean code
• Check the code for errors before submitting a PR
• Add comments wherever necessary to explain whats happening
• Drink caffeine that helps us keep up the good work ;)

Authors

• @zerapium