feat(is): 添加isTruth(是否为真值)方法

src/_base.ts

@@ -10,3 +10,10 @@ export const _toString = (v: unknown): string =>
  * 排除undefined和null类型
  */
 export type _ExcludeUndefinedNull<T> = T extends undefined | null ? never : T
+
+/**
+ * 排除假值类型
+ */
+export type _ExcludeFalsy<T> = T extends false | null | undefined | 0 | ''
+  ? never
+  : T

src/is.ts

@@ -1,4 +1,8 @@
-import { type _ExcludeUndefinedNull, _toString } from './_base'
+import {
+  type _ExcludeFalsy,
+  type _ExcludeUndefinedNull,
+  _toString,
+} from './_base'
 
 /**
  * 是否为Array类型
@@ -206,6 +210,18 @@ export const isString = (v: unknown): v is string => typeof v === 'string'
  */
 export const isSymbol = (v: unknown): v is symbol => typeof v === 'symbol'
 
+/**
+ *
+ * 是否为真值
+ * @param v 要判断的变量
+ * @returns 如果是真值则返回true，否则返回false
+ *
+ * @example
+ * isTruth(false); // false
+ * isTruth(1); // true
+ */
+export const isTruth = <T = any>(v: T): v is _ExcludeFalsy<T> => !isFalsy(v)
+
 /**
  * 是否为undefined
  * @param v 要判断的变量

test/is.test.ts

@@ -16,6 +16,7 @@ import {
   isSet,
   isString,
   isSymbol,
+  isTruth,
   isUnDef,
   isUndefined,
 } from '../src'
@@ -135,6 +136,16 @@ test('isSymbol', () => {
   expect(isSymbol(0)).toBe(false)
 })
 
+test('isTruth', () => {
+  expect(isTruth(false)).toBe(false)
+  expect(isTruth(0)).toBe(false)
+  expect(isTruth('')).toBe(false)
+  expect(isTruth(null)).toBe(false)
+  expect(isTruth(undefined)).toBe(false)
+  expect(isTruth(Number.NaN)).toBe(false)
+  expect(isTruth(1)).toBe(true)
+})
+
 test('isUndefined', () => {
   let a: unknown
   expect(isUndefined(a)).toBe(true)