2.0.0 • Published 2 years ago

utilitylib-js v2.0.0

Weekly downloads
-
License
ISC
Repository
github
Last release
2 years ago

Utilitylib-js

utilitylib is a little utils library for javascript developper

Open Source Love Maintainability Test Coverage GitHub top language example workflow

Installation, import and usage

install library

npm install utilitylib-js

import all library

// import
const util = require('utilitylib-js');

// usage
util.object.clone(objectToClone);

or import just a part of library

// import
const { object } = require('utilitylib-js');

//usage
object.clone(objectToClone);

or just import one method

// import
const { clone } = require('utilitylib-js/src/object');

// usage
clone(objectToClone);

Functions

isNumber(number) ⇒ boolean

check if entry is number

Kind: global function
Returns: boolean - return true if value is a number
Categry: Number
Since: 1.1.0

ParamTypeDescription
numberanyvalue for check is number

Example

isNumber(5)
// => true

merge(array, arrayToMerge) ⇒ Array

merge two array

Kind: global function
Returns: Array - return array merged
Category: Array
Since: 1.0.0

ParamTypeDescription
arrayArrayfirst array
arrayToMergeArrayarray for merge

Example

merge([1, 2], [3, 4])
// => [1, 2, 3, 4]

clone(array) ⇒ Array

clone an array

Kind: global function
Returns: Array - return new instance of array
Category: Array
Since: 1.0.0

ParamTypeDescription
arrayArrayarray for clone

Example

clone([1, 2])
// => [1, 2]

diff(arrayOne, arrayTwo) ⇒ Array

Compare two array and return diff

Kind: global function
Returns: Array - return array of diff between two array
Category: Array
Since: 1.0.0

ParamTypeDescription
arrayOneArrayfirst array
arrayTwoArrayarray for comparaison

Example

diff([1, 2], [1, 3])
// => [2, 3]

isArray(array) ⇒ boolean

check if entry is array

Kind: global function
Returns: boolean - return true if value is a array
Category: Array
Since: 1.1.0

ParamTypeDescription
arrayanyvalue for check is array

Example

isArray([1, 2])
// => true

removeAll(array, values) ⇒ Array

remove values in array

Kind: global function
Returns: Array - return array without value to remove
Category: Array
Since: 1.1.0

ParamTypeDescription
arrayArrayarray contain values for check
valuesArrayarray of values to remove

Example

removeAll([1, 2, 2, 3, 4], [2, 4])
// => [1, 3]

remove(array, ...values) ⇒ Array

remove values in array

Kind: global function
Returns: Array - return array without value to remove
Category: Array
Since: 1.1.0

ParamTypeDescription
arrayArrayarray contain values for check
...valuesanyany values to remove

Example

remove([1, 2, 3, 4], 1, 2)
// => [3, 4]

uniq(array) ⇒ Array.<any>

return array of uniq value work with array of object

Kind: global function
Returns: Array.<any> - return array of uniq values
Category: Array
Since: 1.2.0

ParamTypeDescription
arrayArray.<any>of values any type

Example

uniq([1, 2, 4, 5, 5, 123, 123, 132])

// => [1, 2, 4, 5, 123, 132]

randomNum(min, max) ⇒ number

generate random num beetween two number

Kind: global function
Returns: number - return number generated beetween two values
Category: Number
Since: 1.0.0

ParamTypeDescription
minnumbermin value
maxnumbermax value

Example

randomNum(1, 8)
// => 6

isPrime(number) ⇒ boolean

check if number is prime

Kind: global function
Returns: boolean - return true if this number is a prime number
Category: Number
Since: 1.0.0

ParamTypeDescription
numbernumbernumber for check

Example

isPrime(7)
// => true

even(number) ⇒ boolean

check if number is even

Kind: global function
Returns: boolean - return true if number is even
Category: Number
Since: 1.0.0

ParamTypeDescription
numbernumbernumber for check

Example

even(4)
// => true

odd(number) ⇒ boolean

check if number is odd

Kind: global function
Returns: boolean - return true if number is odd
Category: Number
Since: 1.0.0

ParamTypeDescription
numbernumbernumber for check

Example

odd(5)
// => true

isEqual(objectOne, objectTwo) ⇒ boolean

compare object equality

Kind: global function
Returns: boolean - return true if two object is equal
Category: Object
Since: 1.0.0

ParamTypeDescription
objectOneobjectfirst object to compare
objectTwoobjectother object for comparaison

Example

isEqual({ name: 'test' }, { name: 'test' })
// => true

clone(objectToClone) ⇒ object

clone object

Kind: global function
Returns: object - new instance of this object
Category: Object
Since: 1.0.0

ParamTypeDescription
objectToCloneobjectobject to clone

Example

clone({ name: 'test' })
// => { name: 'test' }

clones(objectsToClone) ⇒ Array.<object>

clone all object in array

Kind: global function
Returns: Array.<object> - return array of object cloned
Category: Object
Since: 1.0.0

ParamTypeDescription
objectsToCloneArray.<object>array of object

Example

clones([{ name: 'test' }])
// => [{ name: 'test' }]

isEmpty(object) ⇒ boolean

check if object is empty

Kind: global function
Returns: boolean - return true if object is empty
Category: Object
Since: 1.0.0

ParamTypeDescription
objectobjectobject for check

Example

isEmpty({})
// => true

merge(object, objectToMerge) ⇒ object

merge two object

Kind: global function
Returns: object - return merged object
Category: Object
Since: 1.0.0

ParamTypeDescription
objectobjectone object
objectToMergeobjectobject for merge

Example

merge({ name: 'snow' }, { firstname: 'jhon' })
// => { name: 'snow', firstname: 'jhon' }

isObject(object) ⇒ boolean

check if entry is object

Kind: global function
Returns: boolean - return true if value is a object
Category: Object
Since: 1.1.0

ParamTypeDescription
objectanyvalue for check is object

Example

isObject({ name: 'test' })
// => true

isVowel(letter) ⇒ boolean

check if letter is vowel

Kind: global function
Returns: boolean - return true if letter is vowel
Category: String
Since: 1.0.0

ParamTypeDescription
letterstringstring letter

Example

isVowel('A')
// => true

isVowels(letters) ⇒ array

check if letters have vowel or consumn

Kind: global function
Returns: array - return array of boolean
Category: String
Since: 1.0.0

ParamTypeDescription
lettersarrayarray of letters

Example

isVowels(['a', 'c', 'e'])
// => [true, false, true]

isConsumn(letter) ⇒ boolean

check if letter is consumn

Kind: global function
Returns: boolean - return true if letter is consumn
Category: String
Since: 1.0.0

ParamTypeDescription
letterstringstring letter

Example

isConsumn('b')
// => true

isConsumns(letters) ⇒ array

check if letters have consumn or vowel

Kind: global function
Returns: array - return array of boolean
Category: String
Since: 1.0.0

ParamTypeDescription
lettersarrayarray of letters

Example

isConcumns(['a', 'b', 'c'])
// => [false, true, true]

getInitialName(fullname, separator) ⇒ string

get initial in full name

Kind: global function
Returns: string - return initial J S
Category: String
Since: 1.0.0

ParamTypeDefaultDescription
fullnamestringfullname 'jhon snow'
separatorstring" "separtor is string for separate initial default ' '

Example

getInitialName('jhon snow', '-')
// => 'J-S'

isString(string) ⇒ boolean

check if entry is string

Kind: global function
Returns: boolean - return true if value is a string
Category: String
Since: 1.1.0

ParamTypeDescription
stringanyvalue for check is string

Example

isString('test')
// => true

camelCaseToOtherCase(value, separator) ⇒ string

convert value in camelCase to kebab-case or snake_case

Kind: global function
Returns: string - return value in kebab-case or snake_case
Category: String
Since: 1.1.0

ParamTypeDescription
valuestringvalue for convert
separatorstringseparator beetween words

Example

camelCaseToOtherCase('testTest', '_')
// => test_test

toKebabCase(value) ⇒ string

convert string in camelCase to kebab-case

Kind: global function
Returns: string - return value in kebab-case
Category: String
Since: 1.1.0

ParamTypeDescription
valuestringvalue for convert

Example

toKebabCase('testTest')
// => test-test

toSnakeCase(value) ⇒ string

convert string in camelCase to kebab-case

Kind: global function
Returns: string - return value in kebab-case
Category: String
Since: 1.1.0

ParamTypeDescription
valuestringvalue for convert

Example

toSnakeCase('testTest')
// => test_test

toPascalCase(value) ⇒ string

convert string in camelCase to PascalCase

Kind: global function
Returns: string - return value in PascalCase
Category: String
Since: 1.1.0

ParamTypeDescription
valuestringvalue for convert

Example

toPascalCase('testTest')
// => TestTest

uuid() ⇒ string

generate a uuid

Kind: global function
Returns: string - return a uuid
Category: String
Since: 1.2.0
Example

uuid()
// => '557abf46-ecf7-4464-a37b-c8cc54bcffb2'