[api] Improved random methods

  * Adds `random.word`
  * Adds `random.words`
  * Adds `random.image` shortcut
  

1 files changed, 58 insertions, 1 deletions

diff --git a/lib/random.js b/lib/random.js
index fc7e54d9..33cf02b7 100644
--- a/lib/random.js
+++ b/lib/random.js
@@ -71,10 +71,67 @@ function Random (faker, seed) {
       return RFC4122_TEMPLATE.replace(/[xy]/g, replacePlaceholders);
   }
 
-  this.boolean =function () {
+  this.boolean = function () {
       return !!faker.random.number(1)
   }
 
+  // TODO: have ability to return specific type of word? As in: noun, adjective, verb, etc
+  this.word = function randomWord (type) {
+
+    var wordMethods = [
+    'commerce.department',
+    'commerce.productName',
+    'commerce.productAdjective',
+    'commerce.productMaterial',
+    'commerce.product',
+    'commerce.color',
+
+    'company.catchPhraseAdjective',
+    'company.catchPhraseDescriptor',
+    'company.catchPhraseNoun',
+    'company.bsAdjective',
+    'company.bsBuzz',
+    'company.bsNoun',
+    'address.streetSuffix',
+    'address.county',
+    'address.country',
+    'address.state',
+
+    'finance.accountName',
+    'finance.transactionType',
+    'finance.currencyName',
+
+    'hacker.noun',
+    'hacker.verb',
+    'hacker.adjective',
+    'hacker.ingverb',
+    'hacker.abbreviation',
+
+    'name.jobDescriptor',
+    'name.jobArea',
+    'name.jobType'];
+
+    // randomly pick from the many faker methods that can generate words
+    var randomWordMethod = faker.random.arrayElement(wordMethods);
+    return faker.fake('{{' + randomWordMethod + '}}');
+
+  }
+
+  this.words = function randomWords (count) {
+    var words = [];
+    if (typeof count === "undefined") {
+      count = faker.random.number({min:1, max: 3});
+    }
+    for (var i = 0; i<count; i++) {
+      words.push(faker.random.word());
+    }
+    return words.join(' ');
+  }
+
+  this.image = function randomImage () {
+    return faker.image.image();
+  }
+
   return this;
 
 }