@nuwatop/utils

一个提供常用类型判断和空值判断的 TypeScript 工具类库。

安装

npm install @nuwatop/utils
# 或
pnpm add @nuwatop/utils
# 或
yarn add @nuwatop/utils

使用方法

import { IsUtils } from '@nuwatop/utils';

// 判断字符串
IsUtils.isString('hello'); // true
IsUtils.isEmptyString(''); // true
IsUtils.isEmptyString('   '); // true

// 判断数字
IsUtils.isNumber(123); // true
IsUtils.isNumber(NaN); // false
IsUtils.isNumber(Infinity); // false

// 判断日期
IsUtils.isDate(new Date()); // true
IsUtils.isValidDate('2024-01-01'); // true
IsUtils.isValidDate('invalid'); // false

// 判断金额
IsUtils.isAmount(100.50); // true
IsUtils.isAmount(-10); // false
IsUtils.isAmountString('1,000.50'); // true
IsUtils.isAmountString('1000.50'); // true

// 判断数组
IsUtils.isArray([1, 2, 3]); // true
IsUtils.isEmptyArray([]); // true
IsUtils.isEmptyArray([1, 2]); // false

// 判断空值
IsUtils.isEmpty(null); // true
IsUtils.isEmpty(undefined); // true
IsUtils.isEmpty(''); // true
IsUtils.isEmpty([]); // true
IsUtils.isEmpty({}); // true

// 判断未定义
IsUtils.isUndefined(undefined); // true
IsUtils.isNull(null); // true
IsUtils.isNullOrUndefined(null); // true
IsUtils.isNullOrUndefined(undefined); // true

// 判断是否有值
IsUtils.hasValue('hello'); // true
IsUtils.hasValue(null); // false
IsUtils.hasValue(undefined); // false
IsUtils.hasValue(''); // false

API 文档

字符串判断

• isString(value: unknown): value is string - 判断是否为字符串
• isEmptyString(value: unknown): boolean - 判断字符串是否为空（包括空字符串、null、undefined）

数字判断

• isNumber(value: unknown): value is number - 判断是否为有效数字（排除 NaN 和 Infinity）

日期判断

• isDate(value: unknown): value is Date - 判断是否为 Date 对象
• isValidDate(value: unknown): boolean - 判断是否为有效的日期字符串或日期对象

金额判断

• isAmount(value: unknown): boolean - 判断是否为金额（正数，可包含小数）
• isAmountString(value: unknown): boolean - 判断是否为金额字符串（支持千分位分隔符）

数组判断

• isArray<T>(value: unknown): value is T[] - 判断是否为数组
• isEmptyArray(value: unknown): boolean - 判断数组是否为空

空值判断

• isEmpty(value: unknown): boolean - 判断值是否为空（null、undefined、空字符串、空数组、空对象）
• hasValue<T>(value: T | null | undefined): value is T - 判断值是否有值（不为空、不为未定义）

未定义判断

• isUndefined(value: unknown): value is undefined - 判断是否为 undefined
• isNull(value: unknown): value is null - 判断是否为 null
• isNullOrUndefined(value: unknown): value is null | undefined - 判断是否为 null 或 undefined

License

MIT