OPEN TECH FOUNDATION

A collection of JavaScript utility functions.

Features

• Simple API
• Practical Default Options
• Includes Async Utils
• TypeScript Support
• ESM

Installation

1npm install @opentf/utils

1yarn add @opentf/utils

1pnpm add @opentf/utils

1bun add @opentf/utils

Usage

1import {
2  isNum,
3  pascalCase,
4  sort,
5  clone,
6  isEql,
7  isEqlArr,
8  sleep,
9} from '@opentf/utils';
10
11isNum(NaN); //=> false
12
13pascalCase('pascal case'); //=> PascalCase
14
15sort([1, 10, 21, 2], 'desc'); //=> [ 21, 10, 2, 1 ]
16
17const obj = {
18  a: 1,
19  b: 'abc',
20  c: new Map([['key', 'val']]),
21};
22clone(obj); // It returns deeply cloned value.
23
24const mapA = new Map([
25  ['a', 1],
26  ['b', 2],
27]);
28const mapB = new Map([
29  ['b', 2],
30  ['a', 1],
31]);
32isEql(mapA, mapB); //=> false
33
34isEqlArr([1, 2, 3], [2, 3, 1]); //=> true
35
36await sleep(1000); // It suspends the exection for 1 second.

API

Array

• arrIns
• arrReplace
• arrRm
• bounds
• chunk
• compact
• countBy
• diff
• groupBy
• intersection
• max
• min
• move
• range
• sort
• sortBy
• symDiff
• union
• uniq

Async

• asyncFilter
• asyncForEach
• asyncMap

Maths

• percentage
• percentageOf

Number

• clamp
• isNegZero
• isZero
• toNum

Function

• sleep
• noop

Colors

• hexToRGB

Assert

• isEmpty
• isEql
• isEqlArr
• isNil
• isShallowEql

Object

• clone
• fromPath
• get
• has
• merge
• mergeAll
• omit
• pick
• set
• shallowMerge
• shallowMergeAll
• size
• toPath
• unset

String

• camelCase
• capitalize
• insertAt
• isEmail
• pascalCase
• replaceAt
• strReplace

Types

• isArr
• isArrBuf
• isBigInt
• isBlob
• isBool
• isDate
• isErr
• isFn
• isJSON
• isMap
• isNull
• isNum
• isObj
• isRegEx
• isSet
• isStr
• isSym
• isTypedArr
• isUndef
• isWkMap
• isWkRef
• isWkSet

Benchmarks

Some benchmark outputs are shown here for reference.

[!IMPORTANT]
Our priorities are reliability and accuracy rather than performance.

1clone:
2┌───┬──────────────────────────┬─────────┬────────────────────┬────────┬─────────┐
3│   │ Task Name                │ ops/sec │ Average Time (ns)  │ Margin │ Samples │
4├───┼──────────────────────────┼─────────┼────────────────────┼────────┼─────────┤
5│ 0 │ structuredClone (Native) │ 246,358 │ 4059.129038804869  │ ±1.65% │ 24636   │
6│ 1 │ _.cloneDeep (Lodash)     │ 169,432 │ 5902.043319168882  │ ±2.53% │ 16944   │
7│ 2 │ R.clone (ramda)          │ 178,957 │ 5587.9189808343945 │ ±2.26% │ 17897   │
8│ 3 │ R2.clone (remeda)        │ 314,247 │ 3182.204862216371  │ ±1.75% │ 31426   │
9│ 4 │ clone                    │ 399,634 │ 2502.2859323385046 │ ±2.06% │ 39964   │
10└───┴──────────────────────────┴─────────┴────────────────────┴────────┴─────────┘
11*Note: Here the ramda & remeda does not support cloning Map & Set.
12
13sortBy:
14┌───┬────────────────────┬───────────┬───────────────────┬────────┬─────────┐
15│   │ Task Name          │ ops/sec   │ Average Time (ns) │ Margin │ Samples │
16├───┼────────────────────┼───────────┼───────────────────┼────────┼─────────┤
17│ 0 │ _.orderBy (Lodash) │ 1,231,295 │ 812.1529684071648 │ ±3.09% │ 123130  │
18│ 1 │ R.sortWith (Ramda) │ 1,279,200 │ 781.7380570822326 │ ±2.27% │ 127921  │
19│ 2 │ R2.sortBy (Remeda) │ 1,419,707 │ 704.3703291518029 │ ±2.81% │ 141971  │
20│ 3 │ sort (Moderndash)  │ 2,697,568 │ 370.7042634668106 │ ±1.82% │ 269757  │
21│ 4 │ sortBy             │ 2,728,366 │ 366.5196435965459 │ ±2.19% │ 272837  │
22└───┴────────────────────┴───────────┴───────────────────┴────────┴─────────┘
23
24*Note: Here the Moderndash does not support passing object prop as string.
25
26isEql:
27┌───┬─────────────────────────────────────┬─────────┬───────────────────┬────────┬─────────┐
28│   │ Task Name                           │ ops/sec │ Average Time (ns) │ Margin │ Samples │
29├───┼─────────────────────────────────────┼─────────┼───────────────────┼────────┼─────────┤
30│ 0 │ deepStrictEqual (Native)            │ 927,921 │ 1077.676882954431 │ ±0.38% │ 92793   │
31│ 1 │ fastDeepEqual (fast-deep-equal/es6) │ 638,108 │ 1567.132684562446 │ ±1.42% │ 63813   │
32│ 2 │ _.isEqual (Lodash)                  │ 142,592 │ 7013.003366058248 │ ±2.13% │ 14260   │
33│ 3 │ R.equals (Ramda)                    │ 50,346  │ 19862.42184707051 │ ±1.83% │ 5035    │
34│ 4 │ isEql                               │ 109,127 │ 9163.615962614227 │ ±1.28% │ 10913   │
35└───┴─────────────────────────────────────┴─────────┴───────────────────┴────────┴─────────┘
36
37*Note:
38
39- The native util `deepStrictEqual` not available in browsers, does not check `Map` ordering & returns false for same invalid dates.
40- The `fast-deep-equal/es6` does not support cyclic refs, Map ordering check, invalid dates, symbols, objects values in Set & TypedArrays.
41- The lodash `isEqual` does not check `Map` ordering & object values in `Set`.
42- The ramda `equals` does not check `Map` ordering & symbols.

Running benchmarks

1$ bun run build
2$ bun benchmark.js

License

Copyright (c) Thanga Ganapathy (MIT License).