Radash 轻量级的函数工具集

Radash 是一个现代的 JavaScript 实用程序库，旨在提供高效、轻量级的函数工具集，类似于 Lodash，但更加现代化和模块化。Radash 通过提供一系列常用的工具函数，帮助开发者更轻松地处理数组、对象、函数等操作。

以下是一些 Radash 中常用的工具函数及其用法示例：

1. _.try

安全地执行一个可能会抛出错误的函数，并返回一个包含错误和结果的元组。

import { try as tryCatch } from 'radash';

const mightThrow = (value) => {
  if (value < 0) {
    throw new Error('Value must be non-negative');
  }
  return value * 2;
};

const [error, result] = tryCatch(() => mightThrow(-1));

if (error) {
  console.error('An error occurred:', error.message);
} else {
  console.log('Result:', result);
}

2. _.debounce

创建一个防抖动函数，在指定时间间隔内只执行一次。

import { debounce } from 'radash';

const log = debounce((message) => {
  console.log(message);
}, 300);

log('Hello');
log('Hello again');  // 只有这条消息会被打印，因为前面的调用在300毫秒内被取消了

3. _.throttle

创建一个节流函数，在指定时间间隔内最多执行一次。

import { throttle } from 'radash';

const log = throttle((message) => {
  console.log(message);
}, 300);

log('Hello');
log('Hello again');  // 只有第一条消息会被打印，后面的调用会被忽略

4. _.merge

深度合并两个对象。

import { merge } from 'radash';

const obj1 = { a: 1, b: { c: 2 } };
const obj2 = { b: { d: 3 }, e: 4 };

const result = merge(obj1, obj2);
console.log(result);  // { a: 1, b: { c: 2, d: 3 }, e: 4 }

5. _.clone

深度克隆一个对象或数组。

import { clone } from 'radash';

const obj = { a: 1, b: { c: 2 } };
const clonedObj = clone(obj);

console.log(clonedObj);  // { a: 1, b: { c: 2 } }
console.log(clonedObj === obj);  // false
console.log(clonedObj.b === obj.b);  // false

6. _.memoize

创建一个记忆化函数，缓存其计算结果。

import { memoize } from 'radash';

const expensiveFunction = (num) => {
  console.log('Computing...');
  return num * 2;
};

const memoizedFunction = memoize(expensiveFunction);

console.log(memoizedFunction(2));  // Computing... 4
console.log(memoizedFunction(2));  // 4 (cached)

7. _.omit

创建一个新对象，忽略指定的属性。

import { omit } from 'radash';

const obj = { a: 1, b: 2, c: 3 };
const newObj = omit(obj, ['b', 'c']);

console.log(newObj);  // { a: 1 }

8. _.pick

创建一个新对象，只包含指定的属性。

import { pick } from 'radash';

const obj = { a: 1, b: 2, c: 3 };
const newObj = pick(obj, ['a', 'c']);

console.log(newObj);  // { a: 1, c: 3 }

9. _.unique

返回一个数组，其中只包含唯一的值。

import { unique } from 'radash';

const arr = [1, 2, 2, 3, 4, 4, 5];
const uniqueArr = unique(arr);

console.log(uniqueArr);  // [1, 2, 3, 4, 5]

10. _.groupBy

根据提供的函数将数组元素分组。

import { groupBy } from 'radash';

const arr = [6.1, 4.2, 6.3];
const grouped = groupBy(arr, Math.floor);

console.log(grouped);  // { '4': [4.2], '6': [6.1, 6.3] }

这些是 Radash 中一些常用的工具函数。Radash 的设计目标是提供现代、轻量且高效的工具函数，帮助开发者更轻松地处理常见的编程任务。你可以在 Radash 的官方文档中找到更多的工具函数及其详细用法。https://radash-docs.vercel.app/docs/getting-started