Added ability to break from Sequencr.for

Break by returning false in the main callback.

Author: JSideris

README.md

@@ -1,4 +1,4 @@
-# Sequencr.js
+# Sequencr.js V2
 Sequencr.js is a super-light-weight library that allows you to easily chain function calls together with timeouts in between, or set timeouts between iterations of a loop.
 
 Please read the wiki for more information, and usage.

Sequencr.dev.js

@@ -1,4 +1,6 @@
 /*
+Sequencr.js V2
+
 The MIT License (MIT)
 Copyright (c) 2016 Joshua Sideris | [email protected] | https://github.com/JSideris/Sequencr.js
 
@@ -20,8 +22,13 @@ function Sequencr() {
 	this.for = function (startInclusive, endExclusive, callback, timeout, onCompleted) {
 		if (startInclusive < endExclusive) {
 			setTimeout(function (This) {
-				callback.call(This, startInclusive);
-				Sequencr.for.apply(This, [startInclusive + 1, endExclusive, callback, timeout, onCompleted]);
+				var ret = callback.call(This, startInclusive);
+				if(ret !== false){
+					Sequencr.for.apply(This, [startInclusive + 1, endExclusive, callback, timeout, onCompleted]);
+				}
+				else if(onCompleted) {
+					onCompleted.call(this);
+				}
 			}, timeout, this);
 		}
 		else if(onCompleted) {

Sequencr.js

@@ -1,4 +1,6 @@
 /*
+Sequencr.js V2
+
 The MIT License (MIT)
 Copyright (c) 2016 Joshua Sideris | [email protected] | https://github.com/JSideris/Sequencr.js
 
@@ -10,4 +12,4 @@ and to permit persons to whom the Software is furnished to do so, subject to the
 The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
 */
 
-function Sequencr(){this.chain=function(n,c){Sequencr["for"].apply(this,[0,n.length,function(c){n[c].call(this)},c])},this["for"]=function(n,c,e,t,i){c>n?setTimeout(function(u){e.call(u,n),Sequencr["for"].apply(u,[n+1,c,e,t,i])},t,this):i&&i.call(this)}}var Sequencr=new Sequencr;
+function Sequencr(){this.chain=function(n,c){Sequencr["for"].apply(this,[0,n.length,function(c){n[c].call(this)},c])},this["for"]=function(n,c,t,e,i){c>n?setTimeout(function(l){var u=t.call(l,n);u!==!1?Sequencr["for"].apply(l,[n+1,c,t,e,i]):i&&i.call(this)},e,this):i&&i.call(this)}}var Sequencr=new Sequencr;

changelog.md

@@ -0,0 +1,3 @@
+#Changes
+V2 - 2016-06-09
+Added ability to break out of a for loop by returning false. This will immediately invoke the onCompleted callback.