feature: add quickFilter

Author: Simon he

README.md

@@ -3,6 +3,7 @@
 - deepMerge    // Object.assign的深度拷贝版本，返回合并后传入的第一个对象
 - asyncPool   // limit：控制异步并发执行的数量，tasks：异步任务数组
 - quickFind   // quickFind(array: any[], key: any),返回一个新的实例,在实例中find方法可以根据key查找对应的项,查找效率O(1)
+- quickFilter // quickFilter(array: any[], key: string | number | Array<string | number>, value: string | number | RegExp), 快速模糊查找key名字的项,支持正则匹配
 
 ## 使用方法
 ### deepMerge
@@ -13,3 +14,5 @@
 ![asyncPool](assets/asyncPool.png)
 ### quickFind
 ![quickFind](assets/quickFind.png)
+### quickFilter
+![quickFilter](assets/quickFilter.png)

assets/quickFilter.png

@@ -3,3 +3,4 @@ export { deepCompare } from './deepCompare'
 export { deepMerge } from './deepMerge'
 export { asyncPool } from './asyncPool'
 export { quickFind } from './quickFind'
+export { quickFilter } from './quickFilter'

src/index.ts

@@ -0,0 +1,15 @@
+export function quickFilter(array: any[], key: string | number | Array<string | number>, value: string | number | RegExp) {
+  const val = String(value)
+  return array.filter(item => {
+    if (Array.isArray(key)) {
+      return key.some(k => findItem(item, k, val))
+    } else {
+      return findItem(item, key, val)
+    }
+  })
+  function findItem(item: Record<any, any>, key: string | number, value: string | RegExp): boolean {
+    const reg = new RegExp(value)
+    return reg.test(item[key])
+  }
+}
+

src/quickFilter.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { asyncPool, deepCompare, deepMerge, quickFind } from '../src'
+import { asyncPool, deepCompare, deepMerge, quickFind, quickFilter } from '../src'
 
 describe('Test 1', () => {
   it('deepMerge test', () => {
@@ -173,3 +173,54 @@ describe('Test 4', () => {
     `)
   })
 })
+
+describe('Test 5', () => {
+  it('quickFilter test', async () => {
+    const arr = [
+      {
+        name: 'simon',
+        age: 18,
+        id: 0,
+      },
+      {
+        name: 'simon1',
+        age: 19,
+        id: 1,
+      },
+      {
+        name: 'simon2',
+        age: 29,
+        id: 2,
+      },
+      {
+        name: 'simon3',
+        age: 29,
+        id: 20,
+      },
+      {
+        name: 'simon3',
+        age: 39,
+        id: 22,
+      },
+      {
+        name: 'simon5',
+        age: 49,
+        id: 3,
+      },
+    ]
+    expect(quickFilter(arr, ['age', 'id'], '3')).toMatchInlineSnapshot(`
+      [
+        {
+          "age": 39,
+          "id": 22,
+          "name": "simon3",
+        },
+        {
+          "age": 49,
+          "id": 3,
+          "name": "simon5",
+        },
+      ]
+    `)
+  })
+})