@flekschas/utils

A collection of handy utility functions

This is a collection of utility functions that I keep using across different projects. I primarily created this package for myself so I don't have to re-implement over and over again and have a central place for testing them.

Install

npm install @flekschas/utils --save-dev

Usage

import { debounce } from '@flekschas/utils';

const hi = debounce(() => {
  console.log('I am debounced');
}, 250);

For cherry picking from a specific topic do:

import { debounce } from '@flekschas/utils/timing';

The utility functions are organized by the following topics:

• animation
• color
• conversion
• dom
• event
• functional-programming
• geometry
• map
• math
• object
• other
• sorting
• string
• timing
• type-checking
• vector

Why

The three core goals of this collection are:

1. Reusability
2. Performance
3. Simplicity

Whenever a function is reusable in a general context I might add it. When I add a function I will make sure it's performant. Finally, every function should be implement as simple as possible without harming performance. There's always a trade-off between performance and simplicity and my philosophy is the following: if the simple and complex implementation perform roughly the same, I choose the simple implementation. If a slightly more complex implementation is much faster I will favor the complex implementation. In any case, the API should always be simple and easy to understand!

Changelog

v0.10.0

• Add hexToRgbArray, hexToRgbaArray, rgbStrToRgbArray, rgbaStrToRgbaArray, rgbStrToDec, rgbToHex, and toRgbaArray to color
• Add isHex(), isNormFloat(), isNormFloatArray(), isRgbArray(), isRgbaArray(), isRgbStr(), isRgbaStr(), isString(), isUint8(), and isUint8Array to type-checking
• Add tests for deepClone()
• Rename hexStrToDec() to hexToDec()
• Fix deepClone() to properly clone getter/setter instead of just cloning the value