Merge pull request #366 from joonhocho/master

[api] Add `faker.random.arrayElements`

1 files changed, 40 insertions, 0 deletions

diff --git a/test/random.unit.js b/test/random.unit.js
index d04bf280..e10d36be 100644
--- a/test/random.unit.js
+++ b/test/random.unit.js
@@ -97,6 +97,46 @@ describe("random.js", function () {
     });
   });
 
+  describe('arrayElements', function() {
+    it('returns a subset with random elements in the array', function() {
+      var testArray = ['hello', 'to', 'you', 'my', 'friend'];
+      var subset = faker.random.arrayElements(testArray);
+
+      // Check length
+      assert.ok(subset.length >= 1 && subset.length <= testArray.length);
+
+      // Check elements
+      subset.forEach(function(element) {
+        assert.ok(testArray.indexOf(element) > -1);
+      });
+
+      // Check uniqueness
+      subset.forEach(function(element) {
+        assert.ok(!this.hasOwnProperty(element));
+        this[element] = true;
+      }, {});
+    });
+
+    it('returns a subset of fixed length with random elements in the array', function() {
+      var testArray = ['hello', 'to', 'you', 'my', 'friend'];
+      var subset = faker.random.arrayElements(testArray, 3);
+
+      // Check length
+      assert.ok(subset.length === 3);
+
+      // Check elements
+      subset.forEach(function(element) {
+        assert.ok(testArray.indexOf(element) > -1);
+      });
+
+      // Check uniqueness
+      subset.forEach(function(element) {
+        assert.ok(!this.hasOwnProperty(element));
+        this[element] = true;
+      }, {});
+    });
+  });
+
   describe('UUID', function() {
     it('should generate a valid UUID', function() {
       var UUID = faker.random.uuid();