feature: add traverse

Author: Simon he

.eslintrc

@@ -1,6 +1,7 @@
 {
   "extends": "@antfu",
   "rules": {
-    "vue/one-component-per-file": "off"
+    "vue/one-component-per-file": "off",
+    "no-console": "off"
   }
 }

README.md

@@ -9,6 +9,11 @@
 - memorizeFn // 根据参数返回一个有缓存的函数
 - debounce // 函数防抖
 - throttle // 函数节流
+- traverse // 遍历对象或数组,快速从options中得到指定的属性值,traverse(arr, {
+      'family.name'(target: any, index: number) {
+        console.log(target, index,)
+      }
+    })
 
 ## 使用方法
 ### deepMerge
@@ -27,4 +32,6 @@
 ![curry](assets/curry.png)
 ### memorizeFn
 ![memorizeFn](assets/memorizeFn.png)
+### traverse
+![traverse](assets/traverse.png)
 

assets/traverse.png

@@ -9,3 +9,4 @@ export { curry } from './curry'
 export { memorizeFn } from './memorizeFn'
 export { debounce } from './debounce'
 export { throttle } from './throttle'
+export { traverse } from './traverse'

src/index.ts

@@ -0,0 +1,18 @@
+export function traverse(target: Record<any, any> | any[], options: Record<string, Function> = {}) {
+  if (typeof target !== 'object')
+    return target
+  Array.isArray(target)
+    ? target.forEach((item, index) => executor(item, index, options))
+    : executor(target, 0, options)
+  return target
+}
+
+function executor(target: Record<any, any>, index: number, options: Record<string, Function> = {}) {
+  for (const key in options) {
+    const result = key.split('.').reduce((_, cur) => {
+      return target[cur]
+    }, '')
+    options[key](result, index, target)
+  }
+}
+

src/traverse.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest'
-import { asyncPool, curry, deepClone, deepCompare, deepMerge, memorizeFn, quickFilter, quickFind } from '../src'
+import { asyncPool, curry, deepClone, deepCompare, deepMerge, memorizeFn, quickFilter, quickFind, traverse } from '../src'
 
 describe('Test 1', () => {
   it('deepMerge test', () => {
@@ -332,3 +332,72 @@ describe('Test 8', () => {
   })
 })
 
+describe('Test 9', () => {
+  it('traverse test', async () => {
+    const arr = [
+      {
+        name: 'simon',
+        family: {
+          bro: 'simonBro',
+        },
+        people: {
+          name: 'simonPeople',
+          family: {
+            bro: 'simonPeopleBro',
+          },
+        },
+      }, {
+        name: 'kitty',
+        family: {
+          bro: 'kittyBro',
+        },
+        people: {
+          name: 'kittyPeople',
+          family: {
+            bro: 'kittyPeopleBro',
+          },
+        },
+      },
+    ]
+    expect(traverse(arr, {
+      'family.name': function (target: any, index: number) {
+        console.log(target, index)
+      },
+      people(target: any, index: number) {
+        target.name = 'haha'
+        console.log(target, index)
+      },
+      'people.family': function (target: any, index: number, item: any) {
+        console.log(target, index, item)
+      },
+    })).toMatchInlineSnapshot(`
+      [
+        {
+          "family": {
+            "bro": "simonBro",
+          },
+          "name": "simon",
+          "people": {
+            "family": {
+              "bro": "simonPeopleBro",
+            },
+            "name": "haha",
+          },
+        },
+        {
+          "family": {
+            "bro": "kittyBro",
+          },
+          "name": "kitty",
+          "people": {
+            "family": {
+              "bro": "kittyPeopleBro",
+            },
+            "name": "haha",
+          },
+        },
+      ]
+    `)
+  })
+})
+