feat(runner): add browser.getProcessedConfig method

Now, instances of the `browser` object have a `getProcessedConfig` method
which returns a promise that resolves to the current Protractor configuration
object for the current runner instance. This means that if multiCapabilities
are being used or tests are sharded, `getProcessedConfig` will return
an object with the `capabilities` and `specs` property specific to the
current instance.

Closes #1724

Author: crrobinson14

docs/referenceConf.js

@@ -193,6 +193,14 @@ exports.config = {
     // are using Jasmine, you can add a reporter with:
     //     jasmine.getEnv().addReporter(new jasmine.JUnitXmlReporter(
     //         'outputdir/', true, true));
+    //
+    // If you need access back to the current configuration object,
+    // use a pattern like the following:
+    //     browser.getProcessedConfig().then(function(config) {
+    //       // config.capabilities is the CURRENT capability being run, if
+    //       // you are using multiCapabilities.
+    //       console.log('Executing capability', config.capabilities);
+    //     });
   },
 
   // A callback function called once tests are finished.

lib/runner.js

@@ -187,6 +187,17 @@ Runner.prototype.createBrowser = function() {
   }
   var self = this; 
 
+  /**
+   * Get the processed configuration object that is currently being run. This
+   * will contain the specs and capabilities properties of the current runner
+   * instance.
+   *
+   * @return {q.Promise} A promise which resolves to the capabilities object.
+   */
+  browser_.getProcessedConfig = function() {
+    return webdriver.promise.fulfilled(config);
+  };
+
   /**
    * Fork another instance of protractor for use in interactive tests.
    *

spec/basic/lib_spec.js

@@ -44,6 +44,26 @@ describe('protractor library', function() {
         expect(browser.driver.getCurrentUrl()).toMatch('#/form');
       });
 
+  it('should have access to the processed config block', function() {
+    function containsMatching(arr, string) {
+      var contains = false;
+      for (var i = 0; i < arr.length; ++i) {
+        if (arr[i].indexOf(string) !== -1) {
+          contains = true;
+        }
+      }
+      return contains;
+    }
+
+    browser.getProcessedConfig().then(function(config) {
+      expect(config.params.login).toBeDefined();
+      expect(config.params.login.user).toEqual('Jane');
+      expect(config.params.login.password).toEqual('1234');
+      expect(containsMatching(config.specs, 'lib_spec.js')).toBe(true);
+      expect(config.capabilities).toBeDefined();
+    });
+  });
+
   it('should allow adding custom locators', function() {
     var findMenuItem = function() {
       var itemName = arguments[0];