feat: add forOwn

src/forOwn.ts

@@ -0,0 +1,18 @@
+/**
+ * 遍历对象的可枚举属性。若回调函数返回 false，遍历会提前退出。
+ *
+ * @param obj 要遍历的对象
+ * @param callback 回调函数
+ */
+export default function forOwn<
+  T extends { [key: string]: any },
+  K extends keyof T
+>(obj: T, callback: (value: T[K], key: K, obj: T) => any): void {
+  for (const key in obj) {
+    if (Object.prototype.hasOwnProperty.call(obj, key)) {
+      if (callback(obj[key], key as any, obj) === false) {
+        break
+      }
+    }
+  }
+}

src/index.ts

@@ -6,6 +6,7 @@ export { default as bindEvent } from './bindEvent'
 export { default as castArray } from './castArray'
 export { default as clamp } from './clamp'
 export { default as Disposer } from './Disposer'
+export { default as forOwn } from './forOwn'
 export { default as inBrowser } from './inBrowser'
 export { default as isFunction } from './isFunction'
 export { default as isNil } from './isNil'

test/index.test.ts

@@ -225,3 +225,33 @@ describe('isNil', () => {
     expect(vtils.isNil(/X/)).toBeFalsy()
   })
 })
+
+describe('forOwn', () => {
+  test('普通对象', () => {
+    const arr: Array<[any, any]> = []
+    vtils.forOwn({ x: 1, y: 2, 3: 3 }, (value, key) => {
+      arr.push([key, value])
+    })
+    expect(arr).toContainEqual(['y', 2])
+    expect(arr).toContainEqual(['x', 1])
+    expect(arr).toContainEqual(['3', 3])
+  })
+  test('Object.create(null)', () => {
+    const obj: { [key: string]: number } = Object.create(null)
+    obj.x = 1
+    obj.y = 2
+    const arr: Array<[any, any]> = []
+    vtils.forOwn(obj, (value, key) => {
+      arr.push([key, value])
+    })
+    expect(arr).toContainEqual(['y', 2])
+    expect(arr).toContainEqual(['x', 1])
+  })
+  test('返回 false 退出遍历', () => {
+    const arr: Array<[any, any]> = []
+    vtils.forOwn({ x: 1, y: 2, 3: 3 }, (value, key) => {
+      return false
+    })
+    expect(arr).toEqual([])
+  })
+})