- Fix a typo in nsCommandProcessor

- Clean-up/add comments to webLoadingListener so it is easier to follow

Author: jleyba

javascript/firefox-driver/js/nsCommandProcessor.js

@@ -204,7 +204,7 @@ DelayedCommand.prototype.execute = function(ms) {
  */
 DelayedCommand.prototype.shouldDelayExecutionForPendingRequest_ = function() {
   var loadStrategy = Utils.getPageLoadingStrategy();
-  if ('unstable' == loadStrategy || 'eager' == loadStrategy && 'none' == loadStrategy) {
+  if ('unstable' == loadStrategy || 'eager' == loadStrategy || 'none' == loadStrategy) {
     return false;
   }
 

javascript/firefox-driver/js/webLoadingListener.js

@@ -162,8 +162,18 @@ ImpatientListener.prototype.onProgressChange = function(webProgress) {
 };
 
 
-var prefs = Components.classes['@mozilla.org/preferences-service;1'].getService(Components.interfaces['nsIPrefBranch']);
+var prefs = Components.classes['@mozilla.org/preferences-service;1']
+    .getService(Components.interfaces['nsIPrefBranch']);
 
+/**
+ * Builds a nsIWebProgressListener for the given browser.
+ * @param {!nsIWebProgress} browser The browser window to listen to for load
+ *     events.
+ * @param {function(boolean)} toCall The function to call when listener detects
+ *     that the browser has finished loading.
+ * @param {Window=} opt_window The DOM window being watched.
+ * @return {!nsIWebProgressListener} The new listener.
+ */
 function buildHandler(browser, toCall, opt_window) {
   var strategy = Utils.getPageLoadingStrategy();
   if ('normal' == strategy) {
@@ -173,13 +183,22 @@ function buildHandler(browser, toCall, opt_window) {
     return new ImpatientListener(browser, toCall, opt_window);
   }
 
-  fxdriver.logging.warn('Unsupported page loading strategy: ' + strategy);
+  fxdriver.logging.warning('Unsupported page loading strategy: ' + strategy);
   // Fall back to 'normal' strategy
   return new PatientListener(browser, toCall, opt_window);
 }
 
 var loadingListenerTimer;
 
+/**
+ * @param {!nsIWebProgress} browser The browser window to listen to for load
+ *     events.
+ * @param {function(boolean)} toCall The function to call when either the
+ *     timeout expires or the browser finishes loading.
+ * @param {number} timeout The timeout to use, in milliseconds.
+ * @param {Window=} opt_window The DOM window being watched.
+ * @constructor
+ */
 WebLoadingListener = function(browser, toCall, timeout, opt_window) {
   var strategy = Utils.getPageLoadingStrategy();
   if ('none' == strategy) {
@@ -188,23 +207,31 @@ WebLoadingListener = function(browser, toCall, timeout, opt_window) {
   }
 
   loadingListenerTimer = new fxdriver.Timer();
-  var func = function(timedOut) { loadingListenerTimer.cancel(); toCall(timedOut); };
+  var func = function(timedOut) {
+    loadingListenerTimer.cancel();
+    toCall(timedOut);
+  };
 
+  /** @type {!nsIWebProgressListener} */
   this.handler = buildHandler(browser, func, opt_window);
-  browser.addProgressListener(this.handler);
-  var handler = this.handler;
 
+  browser.addProgressListener(this.handler);
   if (timeout == -1) {
     timeout = 1000 * 60 * 30; // 30 minutes is a loooong time.
   }
 
+  var handler = this.handler;
   loadingListenerTimer.setTimeout(function() {
-    WebLoadingListener.removeListener(browser, handler);
+    browser.removeProgressListener(handler);
     func(true);
   }, timeout);
 };
 
-
+/**
+ * Removes a progress listener from the given browser.
+ * @param {!nsIWebProgress} browser The browser to remove a listener from.
+ * @param {!WebLoadingListener} listener The listener to remove.
+ */
 WebLoadingListener.removeListener = function(browser, listener) {
-  browser.removeProgressListener(listener);
+  browser.removeProgressListener(listener.handler);
 };