utils-lib-js 2.0.19 → 2.0.21

package/README.en.md

@@ -401,6 +401,33 @@ console.log(demotedArray);
 // Output: reduced array [1, 2, 3, 4, 5]
 ```
 
+##### 4. arrayLoop(list: any[], current? : number): { item: any; current: number }
+
+Walks through the elements in the group and returns the current element and its index.
+
+- 'list' : The array to traverse.
+- 'current' : indicates the index of the current element. The default is 0.
+
+```javascript
+// Each time the arrayLoop function is called, current is incremented by 1 and takes the module length to loop to the beginning of the array.
+const list = [
+  " Element 1",
+  "element 2",
+  " element 3",
+  "element 4",
+  " element 5",
+];
+// Simulation loop multiple times
+let c = 0;
+Array(10)
+  .fill("")
+  .forEach(() => {
+    const { item, current } = arrayLoop(list, c);
+    c = current;
+    console.log(item, c); // 1,2,3,4,0,1,2,3,4,0
+  });
+```
+
 #### function module
 
 ##### 1. `throttle(fn: Function, time: number): Function`

package/README.md

@@ -401,6 +401,27 @@ console.log(demotedArray);
 // 输出: 降维后的数组 [1, 2, 3, 4, 5]
 ```
 
+##### 4. arrayLoop(list: any[], current?: number): { item: any; current: number }
+
+遍历数组中的元素，并返回当前元素及其索引。
+
+- `list`: 要遍历的数组。
+- `current`: 当前元素的索引，默认为 0。
+
+```javascript
+// 每次调用arrayLoop函数时，current将加 1，并取模数组长度，以循环到数组的开始。
+const list = ["元素1", "元素2", "元素3", "元素4", "元素5"];
+// 模拟循环多次
+let c = 0;
+Array(10)
+  .fill("")
+  .forEach(() => {
+    const { item, current } = arrayLoop(list, c);
+    c = current;
+    console.log(item, c); // 1,2,3,4,0,1,2,3,4,0
+  });
+```
+
 #### function 模块
 
 ##### 1. `throttle(fn: Function, time: number): Function`

package/dist/bundle/array.d.ts

@@ -1,10 +1,12 @@
-import { IArrayRandom, IArrayUniq, IArrayDemote, IDemoteArray } from "./types";
+import { IArrayRandom, IArrayUniq, IArrayDemote, IDemoteArray, IArrayLoop } from "./types";
 export declare const arrayRandom: IArrayRandom<any[]>;
 export declare const arrayUniq: IArrayUniq<any[]>;
 export declare const arrayDemote: IArrayDemote<IDemoteArray<any>>;
+export declare const arrayLoop: IArrayLoop;
 declare const _default: {
     arrayRandom: IArrayRandom<any[]>;
     arrayUniq: IArrayUniq<any[]>;
     arrayDemote: IArrayDemote<IDemoteArray<any>>;
+    arrayLoop: IArrayLoop;
 };
 export default _default;

package/dist/bundle/index.d.ts

@@ -50,6 +50,7 @@ declare const _default: {
     arrayRandom: import("./types").IArrayRandom<any[]>;
     arrayUniq: import("./types").IArrayUniq<any[]>;
     arrayDemote: import("./types").IArrayDemote<import("./types").IDemoteArray<any>>;
+    arrayLoop: import("./types").IArrayLoop;
     randomNum: import("./types").IRandomNum;
     urlSplit: import("./types").IUrlSplit;
     urlJoin: import("./types").IUrlJoin;