@feedzai/js-utilities NPM

Intro

In this vast landscape of JavaScript and TypeScript development, having a reliable set of tools at your disposal when building web projects can make all the difference. @feedzai/js-utilities is a comprehensive collection of JavaScript helpers, functions and custom React hooks designed to streamline projects with ease and efficiency.

With this package, developers gain access to a treasure trove of utilities crafted to simplify common tasks encountered in JS/TS projects. From handy helpers to custom React hooks, this library empowers developers to write cleaner, more concise code without sacrificing functionality.

Each function and hook is tested to ensure functionality and effectiveness, whilst giving developers the confidence to integrate them seamlessly into their projects.

It also comes with comprehensive documentation, making it a breeze to navigate and utilize its features effectively.

The package is available in both CommonJS and ES Modules formats so, whether you're working in a traditional environment or embracing the latest ES Modules, we have you covered.

For JavaScript and TypeScript developers seeking a lightweight but robust toolkit that balances simplicity with utility, @feedzai/js-utilities might jus be the answer!

Installation

This module is distributed via npm which is bundled with node and should be installed as one of your project's dependencies or devDependencies:

## using npm
npm install @feedzai/js-utilities

## using yarn
yarn add @feedzai/js-utilities

## using pnpm
pnpm add @feedzai/js-utilities

Usage

This is a collection of functions, utilities and react hooks. You'll find all available code in src.

The bundle is available as:

ES Modules
Common JS

To import a piece of code into your javascript project just do:

// Just one function
import { isNil } from "@feedzai/js-utilities";

// Just a single module, with the full path to the file
import isNil from "@feedzai/js-utilities/dist/functions/typed/is-nil";

// Multiple functions
import { callIfExists, throwError, getLSItem } from "@feedzai/js-utilities";

// React Hooks
import { useMount, useConstant } from "@feedzai/js-utilities/hooks";

// Alias the whole object
import * as JS_UTILS from "@feedzai/js-utilities";

Functions

DOM

Name	Source
classNames	source
cloneValidElement	source
queueMicrotask	source
toggleDataAttribute	source
wait	source

Random

Name	Source
draw	source
random	source

Arrays

Name	Source
arrayMove	source
chunk	source
findIndex	source
find	source
flatMap	source
flatten	source
groupBy	source
inRange	source
includes	source
merge	source
removeIndex	source
removeItem	source
uniqBy	source
uniq	source

Browsers

Name	Source
isBrowser	source
DEV	source

Curry

Name	Source
debounce	source
memo	source
throttle	source

Dates

Name	Source
getBrowserTimezone	source

Events

Name	Source
on	source
off	source
emitCustomEvent	source
useCustomEventListener	source

Internationalization

Name	Source
getBrowserLocale	source

Numbers

Name	Source
formatNumber	source
round	source
shortenNumber	source
toInt	source

Objects

Name	Source
at	source
clone	source
getValue	source
get	source
has	source
isEqual	source
omit	source
pick	source
set	source

String

Name	Source
camelCase	source
capitalize	source
escapeRegExp	source
kebabCase	source
makeId	source
pascalCase	source
readableStringList	source
stripUnit	source
template	source
titleCase	source
trim	source

Typed

Name	Source
boolOrBoolString	source
isArray	source
isBlank	source
isBoolean	source
isDate	source
isElement	source
isEmpty	source
isFunction	source
isNil	source
isNull	source
isNumber	source
isObject	source
isPlainObject	source
isPrimitive	source
isPromise	source
isString	source
isUndefined	source

Utilities

Name	Source
callIfExists	source
emptyFunction	source
makeCancelable	source
throwError	source
HTTP StatusCodes	source
Keyboard Key Codes	source

React Hooks

Name	Source
useContainerQuery	source
useControlledState	source
useNetworkState	source
usePageVisibility	source
usePermission	source
useAutoId	source
useClickOutside	source
useConstant	source
useCopyToClipboard	source
useEffectOnce	source
useLifecycle	source
useLiveRef	source
useMergeRefs	source
useMount	source
useMountedState	source
usePrevious	source
useSafeLayoutEffect	source
useScript	source

Tests

All tests have been written using cypress.

To run tests locally:

# using npm
npm run test:open

# using npm (headless)
npm run test

# using yarn
yarn test:open

# using yarn (headless)
yarn test

Issues

Looking to contribute? Look for the Good First Issue label. You also need to be a Feedzai-aproved contributor to contribute directly to the repo. Otherwise, you always fork the repo and open a merge-request.

See Issues