Add Util.Array.empty()

brunocasanova · Sep 24, 2014 · e3902e9 · e3902e9
1 parent 7f03a71
commit e3902e9
Show file tree

Hide file tree

Showing 3 changed files with 24 additions and 1 deletion.
diff --git a/README.md b/README.md
@@ -138,6 +138,7 @@ var Util = require('findhit-util');
 
 		Util.Array.each() <- Util.Array.forEach()
 		Util.Array.map()
+		Util.Array.empty()
 
 	// String utils
 		// Util.string OR Util.String

diff --git a/lib/type/array.js b/lib/type/array.js
@@ -89,4 +89,15 @@ module.exports = (function ( Util ){
 		return newArray;
 	};
 
+	$.empty = function ( array ) {
+
+		if ( Util.isnt.Array( array ) ) {
+			throw new TypeError("array must be an array");
+		}
+
+		array.splice( 0, array.length );
+
+		return array;
+	};
+
 });
diff --git a/test/type/array.test.js b/test/type/array.test.js
@@ -10,7 +10,7 @@ describe( "Util", function () {
 
 		describe( "array", function () {
 
-			describe( "map", function () {
+			describe( ".map", function () {
 
 				it( "get 3rd value of each array on array", function () {
 					var t, a = [
@@ -28,6 +28,17 @@ describe( "Util", function () {
 
 				});
 
+			});
+
+			describe( ".empty", function () {
+
+				it( "should empty the array", function () {
+					var array = [ 1, 'foo', 'bar', 'lala', 2 ];
+
+					Util.Array.empty( array );
+
+					expect( array ).to.have.length( 0 );
+				});
 
 			});