utjs

utjs is a high performance library with some common functions like sort, concatArrays, randomString, stringToNumber, etc.

Install

npm install utjs

Usage

utjs supports both ES modules and CommonJS on Node.js 18 or newer.

ES modules:

import { randomNumber } from 'utjs';

const number = randomNumber(1, 10);
console.log(number);

CommonJS:

const ut = require('utjs');

const number = ut.randomNumber(1, 10);
console.log(number);

Functions

// Date
function dateToMysql([date=new Date()])
function dateToString([date=new Date()])
function now()
function cloneDate(date)

// Array
function arrayChunk(array, chunkSize)
function sort(array, [comparator=_numericComparator], [left=0], [right=array.length-1])
function swap(array, from, to)
function concatArrays(dest, source)
function copyArray(array, [start=0], [end=array.length])
function clearArray(array)
function randomArray(length, [dataGenerator=_defaultDataGenerator])
function intersectSorted(array1, array2, [comparator=_numericComparator])
function spliceOne(array, index)
function binaryInsert(value, array, [comparator=_numericComparator], [rejectDuplicates=false])
function binarySearch(value, array, [comparator=_numericComparator], [left=0], [right=array.length-1])
function randomArrayItem(array, [start=0], [end=array.length])

// Arguments
function argumentsToArray(args)

// String
function randomString(size, [caseInsensitive=false])
function stringToNumber(string)
function paddingLeft(string, pad, length)
function paddingRight(string, pad, length)
function paddingBoth(string, pad, length)
function repeat(string, times)
function replaceAll(string, substr, newSubstr, [ignoreCase=false])
function startsWith(string, prefix)
function endsWith(string, suffix)
function escapeRegExp(string)
function isDateString(string)
function isHexString(string)
function stringChunk(string, chunkSize)
function splitPath(path)

// Number
function numberToString(number)
function randomNumber(min, max)
function getMiddleNumber(a, b, c)
function numDigits(integer, [base=10])
function isInteger(number)
function isNaN(number)
function isNaNOrInfinity(number)
function truncateNumber(number)

// Object
function mergeObjects(dest, source)
function updateObject(dest, value, path)
function randomObject(lengths, [keyGenerator=_defaultKeyGenerator],
                      [valueGenerator=_defaultValueGenerator])
function objectChunk(object, chunkSize)
function cloneObject(original)
function get(object, path, [def=undefined])
function equals(value, other)
function groupBy(array, keys, [iteratee])
function objectLength(object)
function clearObject(object)
function toFastProperties(object)

// Boolean
function randomBoolean()

// Type
function isNumeric(value)
function isNumber(value)
function isString(value)
function isArray(value)
function isObject(value)
function isPlainObject(value)
function isBoolean(value)
function isFunction(value)
function isRegExp(value)
function isDate(value)
function isValidNumber(value)

// Math
function logN(base, value)

// Miscellaneous
function test(fn, [times=1], [label='Default label'])
function inRange(val, [min=-Infinity], [max=Infinity])
function error([message=''], [constructor=Error])

Objects

// Logging
var logger = {
  DEBUG: 1
  INFO: 2
  WARN: 3
  ERROR: 4
  NONE: Number.MAX_VALUE

  setLogLevel: function(logLevel)
  setUsingDate: function(usingDate)
  setPrettify: function (prettify)

  debug: function(/* arg1, arg2, argN */)
  info: function(/* arg1, arg2, argN */)
  warn: function(/* arg1, arg2, argN */)
  error: function(/* arg1, arg2, argN */)
}

Run benchmarks

node benchmark/index.js BENCHMARK_NAME