🔟 Useful Array Functions (NPM Package)

A lightweight utility package that extends JavaScript arrays with 10 commonly needed, high-performance operations. Perfect for developers looking to simplify array manipulation.

📦 Installation

npm install 10_array_useful_functions

🚀 Usage

const {
  sum,
  unique,
  average,
  max,
  min,
  chunk,
  flatten,
  compact,
  groupBy,
  countBy
} = require('10_array_useful_functions');

const arr = [1, 2, 3, 4, 5];

console.log(sum(arr));                 // 15
console.log(unique([1, 2, 2, 3]));     // [1, 2, 3]
console.log(average(arr));            // 3
console.log(max(arr));                // 5
console.log(min(arr));                // 1
console.log(chunk(arr, 2));           // [[1, 2], [3, 4], [5]]
console.log(flatten([1, [2, [3]]]));  // [1, 2, 3]
console.log(compact([0, 1, false, 2, '', 3])); // [1, 2, 3]
console.log(groupBy(['one', 'two', 'three'], x => x.length)); // { '3': ['one', 'two'], '5': ['three'] }
console.log(countBy([1.1, 2.5, 2.8], Math.floor)); // { '1': 1, '2': 2 }

🔧 Available Functions

| Function | Description | |-----------------------|---------------------------------------------| | sum(arr) | Returns the sum of array elements | | unique(arr) | Returns a new array with unique values | | average(arr) | Returns the average of all numbers | | max(arr) | Returns the maximum number | | min(arr) | Returns the minimum number | | chunk(arr, size) | Breaks array into chunks of given size | | flatten(arr) | Flattens nested arrays into a single array | | compact(arr) | Removes all falsy values | | groupBy(arr, cb) | Groups elements based on a callback function| | countBy(arr, cb) | Counts elements based on a callback function|

📁 Project Structure

.
├── index.js               # Main module with all 10 functions
├── package.json           # NPM metadata and scripts
├── README.md              # Project documentation
└── .github/
    └── workflows/
        └── publish.yml    # GitHub Action for auto publish

👨‍💻 Author

Nishu Kumar

• 🔗 GitHub
• 🔗 NPM Package

📜 License

This project is licensed under the ISC License.