feat(iterate): add function to limit iteration

Author: Shil Sinha

iterUtils.js

@@ -15,6 +15,18 @@ async function *filterIt(filter, iter) {
   }
 }
 
+async function *limitIt(limit, iter) {
+  let count = 0;
+  for await (const item of iter) {
+    if (count === limit) {
+      break
+    }
+
+    count++;
+    yield item;
+  }
+}
+
 /**
  * @template T
  * @implements AsyncIterable<T>
@@ -61,6 +73,14 @@ class DecoratedIterable {
     }
     return result;
   }
+
+  /**
+   * @param {number} limit
+   * @return {DecoratedIterable<T>}
+   */
+  limit(limit) {
+    return new DecoratedIterable(limitIt(limit, this));
+  }
 }
 
 module.exports = {
@@ -73,4 +93,4 @@ module.exports = {
   decorateIt(iter) {
     return new DecoratedIterable(iter);
   }
-};
+};