feat(plugins): skipAngularStability

Author: sjelin

docs/plugins.md

@@ -224,6 +224,23 @@ exports.waitForCondition = function() {};
  * @type {string}
  */
 exports.name = '';
+
+
+/**
+ * Used to turn off default checks for angular stability
+ *
+ * Normally Protractor waits for all $timeout and $http calls to be processed
+ * before executing the next command.  This can be disabled using
+ * browser.ignoreSynchronization, but that will also disable any
+ * <Plugin>.waitForPromise or <Plugin>.waitForCondition checks.  If you want to
+ * disable synchronization with angular, but leave in tact any custom plugin
+ * synchronization, this is the option for you.
+ *
+ * This is used by users who want to replace Protractor's synchronization code
+ * with their own.
+ *
+ * @type {boolean}
+ */
 ```
 
 Each of these exported properties are optional.

lib/plugins.js

@@ -22,6 +22,7 @@ var Plugins = function(config) {
   this.pluginObjs = [];
   this.assertions = {};
   this.resultsReported = false;
+  this.skipAngularStability = false;
   this.pluginConfs.forEach(function(pluginConf, i) {
     var path;
     if (pluginConf.path) {
@@ -45,6 +46,9 @@ var Plugins = function(config) {
     }
 
     annotatePluginObj(self, pluginObj, pluginConf, i);
+    self.skipAngularStability = self.skipAngularStability ||
+        pluginObj.skipAngularStability;
+
     log.debug('Plugin "' + pluginObj.name + '" loaded.');
     self.pluginObjs.push(pluginObj);
   });

lib/protractor.js

@@ -355,7 +355,9 @@ Protractor.prototype.waitForAngular = function(opt_description) {
   }
 
   function runWaitForAngularScript() {
-    if (self.rootEl) {
+    if (self.plugins_.skipAngularStability) {
+      return webdriver.promise.fulfilled();
+    } else if (self.rootEl) {
       return self.executeAsyncScript_(
           clientSideScripts.waitForAngular,
           'Protractor.waitForAngular()' + description,