extra-iterator 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -321,6 +321,12 @@ export declare class ExtraIterator<T> extends Iterator<T, any, any> {
      *     // returns { _a: 2, _b: 4 }
      */
     collect<U>(collectfn: ((iter: Iterable<T>) => U)): U;
+    /**
+     * Sums the numeric value of all elements in the iterator and returns the total.
+     *
+     * @example ExtraIterator.from([5, 8, 13]).sum() // returns 26
+     */
+    sum(): number;
     /**
      * Consumes the iterator and returns the number of elements it contained.
      *

package/dist/index.js

@@ -585,6 +585,14 @@ export class ExtraIterator extends Iterator {
     collect(collectfn) {
         return collectfn(this);
     }
+    /**
+     * Sums the numeric value of all elements in the iterator and returns the total.
+     *
+     * @example ExtraIterator.from([5, 8, 13]).sum() // returns 26
+     */
+    sum() {
+        return this.reduce((a, b) => a + Number(b), 0);
+    }
     /**
      * Consumes the iterator and returns the number of elements it contained.
      *

package/dist/index.test.js

@@ -150,6 +150,20 @@ describe('ExtraIterator', () => {
         const sum = iterator.collect(iter => Array.from(iter).reduce((a, b) => a + b, 0));
         expect(sum).toBe(6);
     });
+    describe('sum', () => {
+        it('should sum numbers', () => {
+            const iter = ExtraIterator.from([5, 8, 13]);
+            expect(iter.sum()).toBe(26);
+        });
+        it('should sum the numeric value of objects', () => {
+            const iter = ExtraIterator.from([
+                { valueOf: () => 5 },
+                { valueOf: () => 8 },
+                { valueOf: () => 13 },
+            ]);
+            expect(iter.sum()).toBe(26);
+        });
+    });
     it('should create a chain of responsibility function', () => {
         const humanizeDuration = ExtraIterator.from([
             (next, miliseconds) => miliseconds < 1000 ? `${miliseconds} miliseconds` : next(miliseconds / 1000),

package/package.json

@@ -3,7 +3,7 @@
   "description": "An extension of the Iterator class with additional utility helper functions.",
   "author": "Leonardo Raele <leonardoraele@gmail.com>",
   "license": "MIT",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js",