feat: add async validation on Is class

Author: jlenon7

README.md

@@ -178,6 +178,9 @@ Is.Uuid('not-valid-uuid') // false
 Is.Cep('not-valid-cep') // false
 Is.Cpf('not-valid-cpf') // false
 Is.Cnpj('not-valid-cnpj') // false
+Is.Async(() => {}) // false
+Is.Async(async () => {}) // true
+Is.Async(() => { new Promise((resolve => resolve())) }) // true
 
 Is.String('value') // true
 Is.Undefined('value') // false

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@secjs/utils",
-  "version": "1.6.2",
+  "version": "1.6.3",
   "description": "",
   "license": "MIT",
   "author": "João Lenon",

src/Classes/Is.ts

@@ -123,6 +123,22 @@ export class Is {
     return isCnpj(cnpj)
   }
 
+  /**
+   * Verify if is an async function
+   *
+   * @param value The value
+   * @return true or false
+   */
+  static Async(value: any) {
+    const fnString = value.toString().trim()
+
+    const validation = !!(
+      fnString.match(/^async/) || fnString.match(/return _ref[^.]*\.apply/)
+    )
+
+    return validation || fnString.includes('new Promise(')
+  }
+
   /**
    * Verify if value is undefined
    *

src/utils/global.ts

@@ -31,6 +31,7 @@ declare global {
     static Cep(cep: string | number): boolean
     static Cpf(cpf: string | number): boolean
     static Cpnj(cnpj: string | number): boolean
+    static Async(value: any): boolean
     static Undefined(value: any): value is undefined
     static Null(value: any): value is null
     static Boolean(value: any): value is boolean

tests/Classes/is.spec.ts

@@ -22,6 +22,14 @@ describe('\n Is Class', () => {
     expect(Is.Cpf('529.461.090-62')).toBe(true)
   })
 
+  it('should verify if is a valid async function', async () => {
+    expect(Is.Async(0)).toBe(false)
+    expect(Is.Async('')).toBe(false)
+    expect(Is.Async(() => '')).toBe(false)
+    expect(Is.Async(async () => '')).toBe(true)
+    expect(Is.Async(() => new Promise(resolve => resolve))).toBe(true)
+  })
+
   it('should verify if is a valid cnpj', async () => {
     expect(Is.Cnpj(0)).toBe(false)
     expect(Is.Cnpj('')).toBe(false)