feat: add _.isBigInt

docs/typed/is-bigint.mdx

@@ -0,0 +1,18 @@
+---
+title: isBigInt
+description: 'Determine if a value is a bigint'
+group: Typed
+---
+
+## Basic usage
+
+Pass in a value and get a boolean telling you if the value is a bigint.
+
+```ts
+import { isBigInt } from 'radash'
+
+isBigInt('hello') // => false
+isBigInt(['hello']) // => false
+isBigInt(12) // => false
+isBigInt(0n) // => true
+```

src/index.ts

@@ -87,6 +87,7 @@ export {
 } from './string'
 export {
   isArray,
+  isBigInt,
   isDate,
   isEmpty,
   isEqual,

src/tests/typed.test.ts

@@ -246,6 +246,62 @@ describe('typed module', () => {
     })
   })
 
+  describe('isBigInt function', () => {
+    test('returns false for null', () => {
+      const result = _.isBigInt(null)
+      assert.isFalse(result)
+    })
+    test('returns false for undefined', () => {
+      const result = _.isBigInt(undefined)
+      assert.isFalse(result)
+    })
+    test('returns false for boolean', () => {
+      const result = _.isBigInt(false)
+      assert.isFalse(result)
+    })
+    test('returns false for class instance', () => {
+      class Data {}
+      const result = _.isBigInt(new Data())
+      assert.isFalse(result)
+    })
+    test('returns false for int', () => {
+      const result = _.isBigInt(22)
+      assert.isFalse(result)
+    })
+    test('returns false for float', () => {
+      const result = _.isBigInt(22.0567)
+      assert.isFalse(result)
+    })
+    test('returns false for NaN', () => {
+      const result = _.isBigInt(NaN)
+      assert.isFalse(result)
+    })
+    test('returns false for array', () => {
+      const result = _.isBigInt([1, 2, 3])
+      assert.isFalse(result)
+    })
+    test('returns false for object', () => {
+      const result = _.isBigInt({})
+      assert.isFalse(result)
+    })
+    test('returns false for string', () => {
+      const result = _.isBigInt('abc')
+      assert.isFalse(result)
+    })
+    test('returns false for string class', () => {
+      const result = _.isBigInt(String('abc'))
+      assert.isFalse(result)
+    })
+    test('returns true for bigint', () => {
+      const result = _.isBigInt(22n)
+      assert.isTrue(result)
+    })
+    test('returns true for bigint class', () => {
+      const result = _.isBigInt(BigInt(22))
+      assert.isTrue(result)
+    })
+  })
+
   describe('isInt function', () => {
     class Data {}
     test('returns false for non-number values', () => {

src/typed.ts

@@ -48,6 +48,10 @@ export const isNumber = (value: any): value is number => {
   }
 }
 
+export const isBigInt = (value: any): value is bigint => {
+  return typeof value === 'bigint'
+}
+
 export const isDate = (value: any): value is Date => {
   return Object.prototype.toString.call(value) === '[object Date]'
 }