Tinkoff Utils

Fast, small and purely functional utility library

Install

$ npm install @tinkoff/utils

Features

• Fast
• Small
• Fully tested
• Documented
• Purely functional
• Modern codebase

Structure of the library

• /object – for objects
• /string – for strings
• /promise – for promises
• /array – for arrays or array-like objects
• /function – for functions – composition, currying and so on, also a set of simple functions (noop, T, F)
• /is – set of type checking methods
• / – root contains utilities which don't satisfy any of the above categories or are universal

Usage

import pathOr from '@tinkoff/utils/object/pathOr';
import compose from '@tinkoff/utils/function/compose';
import toLower from '@tinkoff/utils/string/toLower';
import map from '@tinkoff/utils/array/map'

const toLowerName = compose(
    toLower,
    pathOr(['name'], '')
);
const result = map(toLowerName)([{name: 'testA'}, {name: 'testb'}])

Benchmarks

$ npm run benchmark

Browser support

• Chrome >= 40
• Firefox >= 52
• Edge >= 14
• IE >= 11
• Safari >= 10
• iOS >= 10
• Android >= 4.4

Node support

• 6.4.0 and higher

Bundle size

For detailed comparison with specific libraries see COMPARE.md

2.6.2 (2023-08-01)

2.6.1 (2023-08-01)

Features

• ci: add release workflow with release-it (777b741)

Bug Fixes

• add files to publishing (49c0b80)
• change token settings for release workflow (1a83c59)
• fix publishing files (3c24d4b)
• remove files property from package.json (541ee12)

2.2.1

• add check into the utility isEqual for comparision of functions by reference (#63)

2.1.3

• fix typings for object/groupBy

2.1.1

• add is/reactComponent
• is/reactElement now using react-is package if available
• is/plainObject returns false for react components
• clone will only copy the plain objects instead of copying any object with prototype or react components

2.1.0

• add array/groupBy to group values in array by the list of predicates
• add object/propSetBy and object/pathSetBy functions to allow setting values based on the result of function call
• add utils/assign to create a shallow copy based on type
• object/propSet, object/pathSet won't generate new reference when the object itself doesn't change
• extend types for object/propApply, object/pathApply functions

2.0.0

• add typings
• move docs to branch gh-pages
• add memoize functions
• add is/shallowEqual
• upgrade to babel@7
• fix bug with omit string conversion
• remove is/not
• remove is/contains
• remove sanitize
• fix function/throttleEnd
• fix array/shuffle random generator

1.0.2

• Update docs and license

0.6.2

• Add changelog
• Convert utils build with babel