Add .authentication()

Readme.md

@@ -114,6 +114,18 @@ Saves a screenshot of the current page to the specified `path`. Useful for debug
 #### .useragent(useragent)
 Set the `useragent` used by PhantomJS. You have to set the useragent before calling `.goto()`.
 
+#### .authentication(user, password)
+Set the `user` and `password` for accessing a web page using basic authentication. Be sure to set it before calling `.goto(url)`.
+
+```js
+new Nightmare()
+  .authentication('myUserName','myPassword')
+  .goto('http://httpbin.org/basic-auth/myUserName/myPassword')  
+  .run(function( err, nightmare){
+    console.log("done");
+  });
+```
+
 #### .viewport(width, height)
 Set the `width` and `height` of the viewport, useful for screenshotting. Weirdly, you have to set the viewport before calling `.goto()`.
 

lib/actions.js

@@ -310,6 +310,22 @@ exports.on = function( eventType, callback, done ){
   this.page.set(pageEvent, callback, done);
 }
 
+/*
+ * Sets up basic authentication.
+ *
+ * @param {String} user
+ * @param {Function} password
+ */
+
+exports.authentication = function(user, password, done) {
+  var self = this;
+  this.page.get('settings', function( settings ){
+    settings.userName = user;
+    settings.password = password;
+    self.page.set('settings', settings, done);
+  });
+};
+
 /**
  * Set the useragent.
  *

test/index.js

@@ -347,6 +347,18 @@ describe('Nightmare', function(){
         })
         .run(done);
     });
+
+    it('should set authentication', function(done) {
+      new Nightmare()
+        .authentication('my','auth')
+        .goto('http://httpbin.org/basic-auth/my/auth')
+        .evaluate(function(){
+          return document.body.innerHTML;
+        }, function( data ){
+          data.length.should.be.above(0);
+        })
+        .run(done);
+    });
 
     it('should set viewport', function(done) {
       var size = { width : 400, height: 1000 };