NEW: FTN12 v1.13 #newInstance() support

AsyncSteps.js

@@ -563,6 +563,7 @@ class AsyncSteps {
 
     /**
      * Execute AsyncSteps with Promise interface
+     * @alias AsyncSteps#promise
      * @returns {Promise} - promise wrapper for AsyncSteps
      */
     promise() {
@@ -593,6 +594,15 @@ class AsyncSteps {
         } );
     }
 
+    /**
+     * Create a new instance of AsyncSteps for independent execution
+     * @alias AsyncSteps#newInstance
+     * @returns {AsyncSteps} new instance
+     */
+    newInstance() {
+        return new AsyncSteps( null, this._async_tool );
+    }
+
     /**
      * Not standard API for assertion with multiple instances of the module.
      * @private

CHANGELOG.txt

@@ -1,5 +1,6 @@
 === (next)
 CHANGED: deps maintenance
+NEW: FTN12 v1.13 #newInstance() support
 
 === 2.4.2 (2019-09-27) ===
 CHANGED: deps maintenance

README.md

@@ -23,7 +23,7 @@ Additionally, it supports async/Promise integration as step through `as.await()`
 Reference implementation of:
 
     FTN12: FutoIn Async API
-    Version: 1.11
+    Version: 1.13
 
 Spec: [FTN12: FutoIn Async API v1.x](https://specs.futoin.org/final/preview/ftn12_async_api-1.html)
 
@@ -749,6 +749,8 @@ Execute all remaining events in the internal queue
     * [.forEach(map_or_list, func, [label])](#AsyncSteps+forEach) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.successStep()](#AsyncSteps+successStep) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.await(promise, [onerror])](#AsyncSteps+await) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
+    * [.promise()](#AsyncSteps+promise) ⇒ <code>Promise</code>
+    * [.newInstance()](#AsyncSteps+newInstance) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.success([..._arg])](#AsyncSteps+success)
     * [.setTimeout(timeout_ms)](#AsyncSteps+setTimeout) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.setCancel(oncancel)](#AsyncSteps+setCancel) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
@@ -922,6 +924,20 @@ Integrate a promise as a step.
 | promise | <code>Promise</code> | promise to add as a step |
 | [onerror] | <code>function</code> | error handler to check |
 
+<a name="AsyncSteps+promise"></a>
+
+### asyncSteps.promise() ⇒ <code>Promise</code>
+Execute AsyncSteps with Promise interface
+
+**Kind**: instance method of [<code>AsyncSteps</code>](#AsyncSteps)  
+**Returns**: <code>Promise</code> - - promise wrapper for AsyncSteps  
+<a name="AsyncSteps+newInstance"></a>
+
+### asyncSteps.newInstance() ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
+Create a new instance of AsyncSteps for independent execution
+
+**Kind**: instance method of [<code>AsyncSteps</code>](#AsyncSteps)  
+**Returns**: [<code>AsyncSteps</code>](#AsyncSteps) - new instance  
 <a name="AsyncSteps+success"></a>
 
 ### asyncSteps.success([..._arg])
@@ -1029,6 +1045,8 @@ Continue loop execution from the next iteration, throws exception
     * [.forEach(map_or_list, func, [label])](#AsyncSteps+forEach) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.successStep()](#AsyncSteps+successStep) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.await(promise, [onerror])](#AsyncSteps+await) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
+    * [.promise()](#AsyncSteps+promise) ⇒ <code>Promise</code>
+    * [.newInstance()](#AsyncSteps+newInstance) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.success([..._arg])](#AsyncSteps+success)
     * [.setTimeout(timeout_ms)](#AsyncSteps+setTimeout) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
     * [.setCancel(oncancel)](#AsyncSteps+setCancel) ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
@@ -1202,6 +1220,20 @@ Integrate a promise as a step.
 | promise | <code>Promise</code> | promise to add as a step |
 | [onerror] | <code>function</code> | error handler to check |
 
+<a name="AsyncSteps+promise"></a>
+
+### asyncSteps.promise() ⇒ <code>Promise</code>
+Execute AsyncSteps with Promise interface
+
+**Kind**: instance method of [<code>AsyncSteps</code>](#AsyncSteps)  
+**Returns**: <code>Promise</code> - - promise wrapper for AsyncSteps  
+<a name="AsyncSteps+newInstance"></a>
+
+### asyncSteps.newInstance() ⇒ [<code>AsyncSteps</code>](#AsyncSteps)
+Create a new instance of AsyncSteps for independent execution
+
+**Kind**: instance method of [<code>AsyncSteps</code>](#AsyncSteps)  
+**Returns**: [<code>AsyncSteps</code>](#AsyncSteps) - new instance  
 <a name="AsyncSteps+success"></a>
 
 ### asyncSteps.success([..._arg])

lib/AsyncStepProtector.js

@@ -336,6 +336,15 @@ class AsyncStepProtector {
         return this;
     }
 
+
+    /**
+     * @private
+     * @override
+     */
+    newInstance() {
+        return this._root.newInstance();
+    }
+
     /**
      * @private
      * @override

misc/README.hbs

@@ -23,7 +23,7 @@ Additionally, it supports async/Promise integration as step through `as.await()`
 Reference implementation of:
 
     FTN12: FutoIn Async API
-    Version: 1.11
+    Version: 1.13
 
 Spec: [FTN12: FutoIn Async API v1.x](https://specs.futoin.org/final/preview/ftn12_async_api-1.html)
 

test/unittest.js

@@ -2142,6 +2142,31 @@ if ( typeof Promise !== 'undefined' ) {
                 } );
         } );
     } );
+
+    describe( '#newInstance', function() {
+        it( 'should create on root object', function( done ) {
+            const as = async_steps();
+            const as2 = as.newInstance();
+            expect( as2 ).not.equal( as );
+            expect( as2 ).instanceof( async_steps.AsyncSteps );
+            as2.add( ( as ) => done() ).execute();
+        } );
+
+        it( 'should create on ASP object', function( done ) {
+            const as = async_steps();
+            as.add( ( as ) => {
+                try {
+                    const as2 = as.newInstance();
+                    expect( as2 ).not.equal( as._root );
+                    expect( as2 ).instanceof( async_steps.AsyncSteps );
+                    as2.add( ( as ) => done() ).execute();
+                } catch ( e ) {
+                    done( e );
+                }
+            } );
+            as.execute();
+        } );
+    } );
 }
 
 describe( '.assertAS', function( done ) {