added a 'submit' option to Casper#fill() for submitting the form

@@ -16,36 +16,32 @@ Casper.js is a navigation utility for [PhantomJS](http://www.phantomjs.org/). It
 In the following example, we'll query google for two terms consecutively, `capser` and `homer`, and aggregate the result links in a standard Array. Running the script will output a standard JSON string containing both the logs and the results:
 In the following example, we'll query google for two terms consecutively, `capser` and `homer`, and aggregate the result links in a standard Array. Running the script will output a standard JSON string containing both the logs and the results:
 
 
 ``` javascript
 ``` javascript
-phantom.injectJs('path/to/casper.js');
-
-var links = [];
-var casper = new phantom.Casper({
-    logLevel: "info"
-});
-
-// User defined functions
-function q() {
-    document.querySelector('input[name="q"]').setAttribute('value', '%term%');
-    document.querySelector('form[name="f"]').submit();
-}
-
 function getLinks() {
 function getLinks() {
     var links = document.querySelectorAll('h3.r a');
     var links = document.querySelectorAll('h3.r a');
     return Array.prototype.map.call(links, function(e) {
     return Array.prototype.map.call(links, function(e) {
-        return e.getAttribute('href');
+        return {
+            title: e.innerText,
+            href:  e.getAttribute('href')
+        };
     });
     });
 }
 }
 
 
-// Casper suite
-casper.start('http://google.fr/')
-    .thenEvaluate(q, {
-        term: 'casper'
+var links = [];
+var casper = new phantom.Casper({
+    logLevel: "debug",
+    verbose: true
+})
+    .start('http://google.fr/')
+    .then(function(self) {
+        self.fill('form[name=f]', {
+            q: 'casperjs'
+        }, true);
     })
     })
     .then(function(self) {
     .then(function(self) {
         links = self.evaluate(getLinks);
         links = self.evaluate(getLinks);
-    })
-    .thenEvaluate(q, {
-        term: 'homer'
+        self.fill('form[name=f]', {
+            q: 'plop'
+        }, true);
     })
     })
     .then(function(self) {
     .then(function(self) {
         links = links.concat(self.evaluate(getLinks));
         links = links.concat(self.evaluate(getLinks));
@@ -425,9 +421,9 @@ casper.start('http://www.google.fr/', function(self) {
 });
 });
 ```
 ```
 
 
-### Casper#fill(String selector, Object values)
+### Casper#fill(String selector, Object values, Boolean submit)
 
 
-Fills the fields of a form with given values.
+Fills the fields of a form with given values and optionnaly submit it.
 
 
 Example:
 Example:
 
 
@@ -438,8 +434,7 @@ casper.start('http://some.tld/contact.form', function(self) {
         'content': 'So be careful.',
         'content': 'So be careful.',
         'name':    'Chuck Norris',
         'name':    'Chuck Norris',
         'email':   'chuck@norris.com',
         'email':   'chuck@norris.com',
-    });
-    self.click('input[type=submit]');
+    }, true);
 }).then(function(self) {
 }).then(function(self) {
     self.evaluateOrDie(function() {
     self.evaluateOrDie(function() {
         return /message sent/.test(document.body.innerText);
         return /message sent/.test(document.body.innerText);
@@ -449,7 +444,7 @@ casper.start('http://some.tld/contact.form', function(self) {
 });
 });
 ```
 ```
 
 
-**WARNING:** Please don't use Casper nor PhantomJS to send spam, or I call the Chuck.
+**WARNING:** Please don't use CasperJS nor PhantomJS to send spam, or I'll be calling the Chuck. More seriously, please don't.
 
 
 ### Casper#repeat(int times, function then)
 ### Casper#repeat(int times, function then)
 
 

@@ -298,16 +298,18 @@
          *
          *
          * @param  String  selector  A CSS3 selector to the target form to fill
          * @param  String  selector  A CSS3 selector to the target form to fill
          * @param  Object  values    Field values
          * @param  Object  values    Field values
+         * @param  Boolean submit    Submit the form?
          */
          */
-        fill: function(selector, values) {
+        fill: function(selector, values, submit) {
             if (!typeof(values) === "object") {
             if (!typeof(values) === "object") {
                 throw "form values must be an object";
                 throw "form values must be an object";
             }
             }
             return this.evaluate(function() {
             return this.evaluate(function() {
-                __utils__.fill('%selector%', JSON.parse('%values%'));
+                __utils__.fill('%selector%', JSON.parse('%values%'), JSON.parse('%submit%'));
             }, {
             }, {
                 selector: selector.replace("'", "\'"),
                 selector: selector.replace("'", "\'"),
                 values:   JSON.stringify(values).replace("'", "\'"),
                 values:   JSON.stringify(values).replace("'", "\'"),
+                submit:   JSON.stringify(submit)
             });
             });
         },
         },
 
 
@@ -588,18 +590,18 @@
         };
         };
 
 
         /**
         /**
-         * Fills a form with provided field values.
+         * Fills a form with provided field values, and optionnaly submits it.
          *
          *
          * @param  HTMLElement|String  form  A form element, or a CSS3 selector to a form element
          * @param  HTMLElement|String  form  A form element, or a CSS3 selector to a form element
          * @param  Object              vals  Field values
          * @param  Object              vals  Field values
          */
          */
-        this.fill = function(form, vals) {
+        this.fill = function(form, vals, submit) {
+            submit = typeof(submit) !== "undefined" || false;
             if (!(form instanceof HTMLElement) || typeof(form) === "string") {
             if (!(form instanceof HTMLElement) || typeof(form) === "string") {
                 form = document.querySelector(form);
                 form = document.querySelector(form);
-                console.log('found via selector')
             }
             }
             if (!form) {
             if (!form) {
-                console.log('form not found or invalid');
+                console.log('form not found or invalid selector provided:');
                 return;
                 return;
             }
             }
             for (var name in vals) {
             for (var name in vals) {
@@ -614,6 +616,9 @@
                 }
                 }
                 this.setField(field, value);
                 this.setField(field, value);
             }
             }
+            if (submit) {
+                form.submit();
+            }
         };
         };
 
 
         /**
         /**
@@ -651,6 +656,8 @@
             if (!field instanceof HTMLElement) {
             if (!field instanceof HTMLElement) {
                 console.log('the field must be an HTMLElement');
                 console.log('the field must be an HTMLElement');
                 return;
                 return;
+            } else {
+                console.log('set "' + field.getAttribute('name') + '" value to ' + value);
             }
             }
             value = value || "";
             value = value || "";
             switch (field.nodeName.toLowerCase()) {
             switch (field.nodeName.toLowerCase()) {