Overview

JS Utils Kit is a compact and reliable library of essential JavaScript utility functions. It includes helpers for arrays, objects, numbers, promises, type checking, and more. Designed for performance and modularity, it integrates easily into JavaScript and TypeScript projects with minimal impact on bundle size.

Streamline your code with battle-tested, tree-shakable utilities.

This package includes utilities designed for both browser and Node.js environments, clearly organized and optimized for cross-platform compatibility.

Features

• Organized by category (e.g., number, string, file, etc.)
• Fully typed in TypeScript
• Thoroughly tested with Jest
• Tree‑shakeable and supports both ESM and CJS
• CLI-ready tools for file and system operations

Installation

# via npm
npm install js-utils-kit

# via yarn
yarn add js-utils-kit

# via pnpm
pnpm add js-utils-kit

# via bun
bun add js-utils-kit

# via Deno (using npm)
deno add npm:js-utils-kit

# via Deno (using JSR)
deno add jsr:@tene/js-utils-kit

# via JSR
npx jsr add @tene/js-utils-kit
Copy

Usage

js-utils-kit offers a modular structure for utilities across different categories like number, string, array, object, env, and more. You can use full or scoped imports depending on your preference and project setup.

Recommended Import

Import only what you need by utility category:

import number from 'js-utils-kit/number';
import string from 'js-utils-kit/string';
import array from 'js-utils-kit/array';
import object from 'js-utils-kit/object';
import env from 'js-utils-kit/env';

console.log(number.clamp(150, 0, 100)); // 100
console.log(string.capitalize('hello world')); // 'Hello World'
console.log(array.unique([1, 2, 2, 3])); // [1, 2, 3]
console.log(object.isEmpty({})); // true
console.log(env.isBrowser()); // true/false
Copy

Full Import (All utils in one namespace)

import * as kit from 'js-utils-kit';

console.log(kit.number.clamp(150, 0, 100)); // 100
console.log(kit.string.capitalize('hello')); // 'Hello'
console.log(kit.array.unique([1, 1, 2])); // [1, 2]
console.log(kit.object.isEmpty({})); // true
console.log(kit.env.isNode()); // true/false
Copy

Named Imports

import { number, string, env } from 'js-utils-kit';

console.log(number.clamp(42, 0, 100)); // 42
console.log(string.capitalize('js-utils-kit')); // 'Js-utils-kit'
console.log(env.isDev()); // true/false
Copy

Using JSR or Deno

import { number, string, env } from '@tene/js-utils-kit';
// or
import { number, string, env } from 'jsr:@tene/js-utils-kit';
// or
import number from '@tene/js-utils-kit/number';
import string from '@tene/js-utils-kit/string';
import array from '@tene/js-utils-kit/array';
import object from '@tene/js-utils-kit/object';
import env from '@tene/js-utils-kit/env';
Copy

CommonJS Usage

const { number, string, array, object, env } = require('js-utils-kit');

console.log(number.clamp(150, 0, 100)); // 100
console.log(string.capitalize('hello world')); // 'Hello World'
console.log(array.unique([1, 2, 2, 3])); // [1, 2, 3]
console.log(object.isEmpty({})); // true
console.log(env.isBrowser()); // true/false
Copy

Documentation

Full documentation available at GitHub Pages

Requirements

• Node.js: Version 18.0.0 or higher
• Yarn (or npm as an alternative)
• TypeScript (optional, for TypeScript projects or development)
• Browsers: Modern browsers for browser-based usage

Contributing

We welcome contributions whether it's fixing bugs, adding utilities, improving docs, or writing tests. See CONTRIBUTING.md for guidelines and join our GitHub Discussions to share ideas or propose features.

FAQ

import { clamp } from 'js-utils-kit/number';
Copy

License

Released under the MIT License