Common 常用工具

通用工具函数集合。

安装

npm
yarn
pnpm
bun
deno
npx shadcn@latest add https://codebase.anyask.dev/r/utils-common.json

快速开始

import { sleep, isEmpty, clamp, getLastOfEachSubarray } from '@/utils';

// 使用工具函数
await sleep(1000);
isEmpty(null);
clamp(value, 0, 100);
getLastOfEachSubarray([[1, 2], [3, 4]]);

sleep

异步等待指定时间。

使用示例

API

签名: sleep(ms: number): Promise<void>

参数说明类型默认值
ms等待的毫秒数number-

isEmpty

检查值是否为空。

使用示例

API

签名: isEmpty(value: FormatNumberInput): boolean

参数说明类型默认值
value要检查的值FormatNumberInput-

返回值: boolean - true 表示值为空

支持的空值:

  • null
  • undefined
  • '' (空字符串)

不视为空值:

  • 0
  • false
  • ' ' (空格字符串)

clamp

将一个数值约束在指定的区间内。

使用示例

API

签名: clamp(value: number, min: number, max: number): number

参数说明类型默认值
value需要被裁剪的数值number-
min区间的最小边界(包含)number-
max区间的最大边界(包含)number-

返回值: 被裁剪后的数值,确保 min <= 返回值 <= max


getLastOfEachSubarray

获取每个子数组的最后一个元素。

使用示例

API

签名: getLastOfEachSubarray&lt;T&gt;(arrays?: Array&lt;T[] | null&gt; | null): T[]

参数说明类型默认值
arrays可能包含若干子数组的二维数组`Array<T[]null> | null`

返回值: 包含所有非空子数组最后一个元素的数组