RubyGems - rainux-selenium-webdriver - Versions diffs - 0.0.17 - Mend

rainux-selenium-webdriver 0.0.17

Files changed (192) hide show

data/COPYING +204 -0
data/chrome/prebuilt/Win32/Release/npchromedriver.dll +0 -0
data/chrome/prebuilt/x64/Release/npchromedriver.dll +0 -0
data/chrome/src/extension/background.html +9 -0
data/chrome/src/extension/background.js +995 -0
data/chrome/src/extension/content_script.js +1321 -0
data/chrome/src/extension/icons/busy.png +0 -0
data/chrome/src/extension/icons/free.png +0 -0
data/chrome/src/extension/manifest-nonwin.json +19 -0
data/chrome/src/extension/manifest-win.json +20 -0
data/chrome/src/extension/utils.js +231 -0
data/chrome/src/rb/lib/selenium/webdriver/chrome.rb +8 -0
data/chrome/src/rb/lib/selenium/webdriver/chrome/bridge.rb +358 -0
data/chrome/src/rb/lib/selenium/webdriver/chrome/command_executor.rb +124 -0
data/chrome/src/rb/lib/selenium/webdriver/chrome/launcher.rb +135 -0
data/common/src/js/abstractcommandprocessor.js +134 -0
data/common/src/js/asserts.js +296 -0
data/common/src/js/by.js +149 -0
data/common/src/js/command.js +304 -0
data/common/src/js/context.js +58 -0
data/common/src/js/core/Blank.html +7 -0
data/common/src/js/core/InjectedRemoteRunner.html +8 -0
data/common/src/js/core/RemoteRunner.html +101 -0
data/common/src/js/core/SeleniumLog.html +109 -0
data/common/src/js/core/TestPrompt.html +145 -0
data/common/src/js/core/TestRunner-splash.html +55 -0
data/common/src/js/core/TestRunner.html +165 -0
data/common/src/js/core/icons/all.png +0 -0
data/common/src/js/core/icons/continue.png +0 -0
data/common/src/js/core/icons/continue_disabled.png +0 -0
data/common/src/js/core/icons/pause.png +0 -0
data/common/src/js/core/icons/pause_disabled.png +0 -0
data/common/src/js/core/icons/selected.png +0 -0
data/common/src/js/core/icons/step.png +0 -0
data/common/src/js/core/icons/step_disabled.png +0 -0
data/common/src/js/core/lib/cssQuery/cssQuery-p.js +6 -0
data/common/src/js/core/lib/cssQuery/src/cssQuery-level2.js +142 -0
data/common/src/js/core/lib/cssQuery/src/cssQuery-level3.js +150 -0
data/common/src/js/core/lib/cssQuery/src/cssQuery-standard.js +53 -0
data/common/src/js/core/lib/cssQuery/src/cssQuery.js +356 -0
data/common/src/js/core/lib/prototype.js +2006 -0
data/common/src/js/core/lib/scriptaculous/builder.js +101 -0
data/common/src/js/core/lib/scriptaculous/controls.js +815 -0
data/common/src/js/core/lib/scriptaculous/dragdrop.js +915 -0
data/common/src/js/core/lib/scriptaculous/effects.js +958 -0
data/common/src/js/core/lib/scriptaculous/scriptaculous.js +47 -0
data/common/src/js/core/lib/scriptaculous/slider.js +283 -0
data/common/src/js/core/lib/scriptaculous/unittest.js +383 -0
data/common/src/js/core/lib/snapsie.js +91 -0
data/common/src/js/core/scripts/find_matching_child.js +69 -0
data/common/src/js/core/scripts/htmlutils.js +8716 -0
data/common/src/js/core/scripts/injection.html +72 -0
data/common/src/js/core/scripts/selenium-api.js +3291 -0
data/common/src/js/core/scripts/selenium-browserbot.js +2457 -0
data/common/src/js/core/scripts/selenium-browserdetect.js +153 -0
data/common/src/js/core/scripts/selenium-commandhandlers.js +379 -0
data/common/src/js/core/scripts/selenium-executionloop.js +175 -0
data/common/src/js/core/scripts/selenium-logging.js +148 -0
data/common/src/js/core/scripts/selenium-remoterunner.js +695 -0
data/common/src/js/core/scripts/selenium-testrunner.js +1362 -0
data/common/src/js/core/scripts/selenium-version.js +5 -0
data/common/src/js/core/scripts/ui-doc.html +808 -0
data/common/src/js/core/scripts/ui-element.js +1644 -0
data/common/src/js/core/scripts/ui-map-sample.js +979 -0
data/common/src/js/core/scripts/user-extensions.js +3 -0
data/common/src/js/core/scripts/user-extensions.js.sample +75 -0
data/common/src/js/core/scripts/xmlextras.js +153 -0
data/common/src/js/core/selenium-logo.png +0 -0
data/common/src/js/core/selenium-test.css +43 -0
data/common/src/js/core/selenium.css +316 -0
data/common/src/js/core/xpath/dom.js +566 -0
data/common/src/js/core/xpath/javascript-xpath-0.1.11.js +2816 -0
data/common/src/js/core/xpath/util.js +549 -0
data/common/src/js/core/xpath/xmltoken.js +149 -0
data/common/src/js/core/xpath/xpath.js +2481 -0
data/common/src/js/extension/README +2 -0
data/common/src/js/extension/dommessenger.js +152 -0
data/common/src/js/factory.js +55 -0
data/common/src/js/future.js +141 -0
data/common/src/js/jsunit.js +40 -0
data/common/src/js/jsunit/app/css/jsUnitStyle.css +50 -0
data/common/src/js/jsunit/app/css/readme +10 -0
data/common/src/js/jsunit/app/emptyPage.html +11 -0
data/common/src/js/jsunit/app/jsUnitCore.js +534 -0
data/common/src/js/jsunit/app/jsUnitMockTimeout.js +81 -0
data/common/src/js/jsunit/app/jsUnitTestManager.js +705 -0
data/common/src/js/jsunit/app/jsUnitTestSuite.js +44 -0
data/common/src/js/jsunit/app/jsUnitTracer.js +102 -0
data/common/src/js/jsunit/app/jsUnitVersionCheck.js +59 -0
data/common/src/js/jsunit/app/main-counts-errors.html +12 -0
data/common/src/js/jsunit/app/main-counts-failures.html +13 -0
data/common/src/js/jsunit/app/main-counts-runs.html +13 -0
data/common/src/js/jsunit/app/main-counts.html +21 -0
data/common/src/js/jsunit/app/main-data.html +178 -0
data/common/src/js/jsunit/app/main-errors.html +23 -0
data/common/src/js/jsunit/app/main-frame.html +19 -0
data/common/src/js/jsunit/app/main-loader.html +45 -0
data/common/src/js/jsunit/app/main-progress.html +25 -0
data/common/src/js/jsunit/app/main-results.html +67 -0
data/common/src/js/jsunit/app/main-status.html +13 -0
data/common/src/js/jsunit/app/testContainer.html +16 -0
data/common/src/js/jsunit/app/testContainerController.html +77 -0
data/common/src/js/jsunit/app/xbDebug.js +306 -0
data/common/src/js/jsunit/changelog.txt +60 -0
data/common/src/js/jsunit/css/jsUnitStyle.css +83 -0
data/common/src/js/jsunit/images/green.gif +0 -0
data/common/src/js/jsunit/images/logo_jsunit.gif +0 -0
data/common/src/js/jsunit/images/powerby-transparent.gif +0 -0
data/common/src/js/jsunit/images/red.gif +0 -0
data/common/src/js/jsunit/licenses/JDOM_license.txt +56 -0
data/common/src/js/jsunit/licenses/Jetty_license.html +213 -0
data/common/src/js/jsunit/licenses/MPL-1.1.txt +470 -0
data/common/src/js/jsunit/licenses/gpl-2.txt +340 -0
data/common/src/js/jsunit/licenses/index.html +141 -0
data/common/src/js/jsunit/licenses/lgpl-2.1.txt +504 -0
data/common/src/js/jsunit/licenses/mpl-tri-license-c.txt +35 -0
data/common/src/js/jsunit/licenses/mpl-tri-license-html.txt +35 -0
data/common/src/js/jsunit/readme.txt +19 -0
data/common/src/js/jsunit/testRunner.html +167 -0
data/common/src/js/jsunit/version.txt +1 -0
data/common/src/js/key.js +117 -0
data/common/src/js/localcommandprocessor.js +185 -0
data/common/src/js/testcase.js +217 -0
data/common/src/js/timing.js +89 -0
data/common/src/js/webdriver.js +890 -0
data/common/src/js/webelement.js +485 -0
data/common/src/rb/README +30 -0
data/common/src/rb/lib/selenium-webdriver.rb +1 -0
data/common/src/rb/lib/selenium/webdriver.rb +67 -0
data/common/src/rb/lib/selenium/webdriver/bridge_helper.rb +91 -0
data/common/src/rb/lib/selenium/webdriver/child_process.rb +180 -0
data/common/src/rb/lib/selenium/webdriver/core_ext/dir.rb +41 -0
data/common/src/rb/lib/selenium/webdriver/driver.rb +252 -0
data/common/src/rb/lib/selenium/webdriver/driver_extensions/takes_screenshot.rb +24 -0
data/common/src/rb/lib/selenium/webdriver/element.rb +262 -0
data/common/src/rb/lib/selenium/webdriver/error.rb +67 -0
data/common/src/rb/lib/selenium/webdriver/find.rb +89 -0
data/common/src/rb/lib/selenium/webdriver/keys.rb +84 -0
data/common/src/rb/lib/selenium/webdriver/navigation.rb +27 -0
data/common/src/rb/lib/selenium/webdriver/options.rb +50 -0
data/common/src/rb/lib/selenium/webdriver/platform.rb +86 -0
data/common/src/rb/lib/selenium/webdriver/target_locator.rb +70 -0
data/firefox/prebuilt/Win32/Release/webdriver-firefox.dll +0 -0
data/firefox/prebuilt/linux/Release/libwebdriver-firefox.so +0 -0
data/firefox/prebuilt/linux/Release/x_ignore_nofocus.so +0 -0
data/firefox/prebuilt/linux64/Release/libwebdriver-firefox.so +0 -0
data/firefox/prebuilt/linux64/Release/x_ignore_nofocus.so +0 -0
data/firefox/prebuilt/nsICommandProcessor.xpt +0 -0
data/firefox/prebuilt/nsINativeEvents.xpt +0 -0
data/firefox/prebuilt/nsIResponseHandler.xpt +0 -0
data/firefox/src/extension/chrome.manifest +3 -0
data/firefox/src/extension/components/badCertListener.js +294 -0
data/firefox/src/extension/components/context.js +37 -0
data/firefox/src/extension/components/driver-component.js +127 -0
data/firefox/src/extension/components/firefoxDriver.js +810 -0
data/firefox/src/extension/components/json2.js +273 -0
data/firefox/src/extension/components/keytest.html +554 -0
data/firefox/src/extension/components/nsCommandProcessor.js +643 -0
data/firefox/src/extension/components/promptService.js +208 -0
data/firefox/src/extension/components/screenshooter.js +81 -0
data/firefox/src/extension/components/socketListener.js +185 -0
data/firefox/src/extension/components/utils.js +1263 -0
data/firefox/src/extension/components/webLoadingListener.js +57 -0
data/firefox/src/extension/components/webdriverserver.js +106 -0
data/firefox/src/extension/components/wrappedElement.js +683 -0
data/firefox/src/extension/content/fxdriver.xul +30 -0
data/firefox/src/extension/content/server.js +95 -0
data/firefox/src/extension/idl/nsICommandProcessor.idl +38 -0
data/firefox/src/extension/idl/nsIResponseHandler.idl +34 -0
data/firefox/src/extension/install.rdf +29 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox.rb +31 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/binary.rb +107 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/bridge.rb +484 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/extension_connection.rb +90 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/launcher.rb +155 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/profile.rb +233 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/profiles_ini.rb +59 -0
data/firefox/src/rb/lib/selenium/webdriver/firefox/util.rb +23 -0
data/jobbie/prebuilt/Win32/Release/InternetExplorerDriver.dll +0 -0
data/jobbie/prebuilt/x64/Release/InternetExplorerDriver.dll +0 -0
data/jobbie/src/rb/lib/selenium/webdriver/ie.rb +14 -0
data/jobbie/src/rb/lib/selenium/webdriver/ie/bridge.rb +565 -0
data/jobbie/src/rb/lib/selenium/webdriver/ie/lib.rb +99 -0
data/jobbie/src/rb/lib/selenium/webdriver/ie/util.rb +147 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote.rb +16 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote/bridge.rb +408 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote/capabilities.rb +105 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote/commands.rb +53 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote/default_http_client.rb +71 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote/response.rb +49 -0
data/remote/client/src/rb/lib/selenium/webdriver/remote/server_error.rb +32 -0
metadata +303 -0

data/chrome/src/rb/lib/selenium/webdriver/chrome/command_executor.rb ADDED

@@ -0,0 +1,124 @@
+module Selenium
+  module WebDriver
+    module Chrome
+     class CommandExecutor
+       HTML_TEMPLATE = "HTTP/1.1 200 OK\r\nContent-Length: %d\r\nContent-Type: text/html; charset=UTF-8\r\n\r\n%s"
+       JSON_TEMPLATE = "HTTP/1.1 200 OK\r\nContent-Length: %d\r\nContent-Type: application/json; charset=UTF-8\r\n\r\n%s"
+       def initialize
+         @server       = TCPServer.new(localhost, 0)
+         @queue        = Queue.new
+         @accepted_any = false
+         @next_socket  = nil
+         @listening    = true
+         Thread.new { start_run_loop }
+       end
+       def execute(command)
+         until accepted_any?
+           Thread.pass
+           sleep 0.01
+         end
+         json = command.to_json
+         data = JSON_TEMPLATE % [json.length, json]
+         @next_socket.write data
+         @next_socket.close
+         JSON.parse read_response(@queue.pop)
+       end
+       def close
+         stop_listening
+         close_sockets
+         @server.close unless @server.closed?
+       rescue IOError
+         nil
+       end
+       def port
+         @server.addr[1]
+       end
+       def uri
+         "http://localhost:#{port}/chromeCommandExecutor"
+       end
+       private
+       def localhost
+         Platform.ironruby? ? "localhost" : "0.0.0.0" # yeah, weird..
+       end
+       def start_run_loop
+         while(@listening) do
+           socket = @server.accept
+           if socket.read(1) == "G" # initial GET(s)
+             write_holding_page_to socket
+           else
+             if accepted_any?
+               @queue << socket
+             else
+               read_response(socket)
+               @accepted_any = true
+             end
+           end
+         end
+       rescue IOError, Errno::EBADF
+         raise unless @server.closed?
+       end
+       def read_response(socket)
+         result = ''
+         seen_double_crlf = false
+         while line = next_line(socket)
+           seen_double_crlf = true if line.empty?
+           result << "#{line}\n" if seen_double_crlf
+         end
+         @next_socket = socket
+         result.strip!
+       end
+       def accepted_any?
+         @accepted_any
+       end
+       def close_sockets
+         @queue.pop.close until @queue.empty?
+         @next_socket.close if @next_socket
+       end
+       def stop_listening
+         @listening = false
+       end
+       def next_line(socket)
+        return if socket.closed?
+        input = socket.gets
+        raise Error::WebDriverError, "unexpected EOF from Chrome" if input.nil?
+        line = input.chomp
+        return if line == "EOResponse"
+        line
+       end
+       def write_holding_page_to(socket)
+         msg = %[<html><head><script type='text/javascript'>if (window.location.search == '') { setTimeout("window.location = window.location.href + '?reloaded'", 5000); }</script></head><body><p>ChromeDriver server started and connected.  Please leave this tab open.</p></body></html>]
+         socket.write HTML_TEMPLATE % [msg.length, msg]
+         socket.close
+       end
+     end # CommandExecutor
+    end # Chrome
+  end # WebDriver
+end # Selenium

data/chrome/src/rb/lib/selenium/webdriver/chrome/launcher.rb ADDED

@@ -0,0 +1,135 @@
+module Selenium
+  module WebDriver
+    module Chrome
+      class Launcher
+        include FileUtils
+        attr_reader :pid
+        def self.launcher
+          launcher =  case Platform.os
+                      when :windows
+                        WindowsLauncher.new
+                      when :macosx
+                        MacOSXLauncher.new
+                      when :unix, :linux
+                        UnixLauncher.new
+                      else
+                        raise "unknown OS: #{Platform.os}"
+                      end
+          launcher
+        end
+        def launch(server_url)
+          create_extension
+          create_profile
+          launch_chrome server_url
+          pid
+        end
+        def kill
+          @process.kill
+        end
+        private
+        def create_extension
+          # TODO: find a better way to do this
+          rm_rf tmp_extension_dir
+          mkdir_p File.dirname(tmp_extension_dir), :mode => 0700
+          cp_r ext_path, tmp_extension_dir
+          if Platform.win?
+            cp linked_lib_path, tmp_extension_dir
+            mv "#{tmp_extension_dir}/manifest-win.json", "#{tmp_extension_dir}/manifest.json"
+          else
+            mv "#{tmp_extension_dir}/manifest-nonwin.json", "#{tmp_extension_dir}/manifest.json"
+          end
+        end
+        def create_profile
+          touch "#{tmp_profile_dir}/First Run"
+          touch "#{tmp_profile_dir}/First Run Dev"
+        end
+        def launch_chrome(server_url)
+          check_binary_exists
+          @process = ChildProcess.new Platform.wrap_in_quotes_if_necessary(binary_path),
+                                      "--load-extension=#{Platform.wrap_in_quotes_if_necessary tmp_extension_dir}",
+                                      "--user-data-dir=#{Platform.wrap_in_quotes_if_necessary tmp_profile_dir}",
+                                      "--activate-on-launch",
+                                      "--disable-hang-monitor",
+                                      "--disable-popup-blocking",
+                                      "--disable-prompt-on-repost",
+                                      server_url
+          @process.start
+        end
+        def check_binary_exists
+          unless File.file?(binary_path)
+            raise Error::WebDriverError, "Could not find Chrome binary. Make sure Chrome is installed (OS: #{Platform.os})"
+          end
+        end
+        def ext_path
+          @ext_path ||= "#{WebDriver.root}/chrome/src/extension"
+        end
+        def tmp_extension_dir
+          @tmp_extension_dir ||= begin
+            dir = Dir.mktmpdir("webdriver-chrome-extension")
+            Platform.make_writable(dir)
+            dir
+          end
+        end
+        def tmp_profile_dir
+          @tmp_profile_dir ||= begin
+            dir = Dir.mktmpdir("webdriver-chrome-profile")
+            Platform.make_writable(dir)
+            dir
+          end
+        end
+        class WindowsLauncher < Launcher
+          def linked_lib_path
+            # TODO: x64
+            @linked_lib_path ||= "#{WebDriver.root}/chrome/prebuilt/Win32/Release/npchromedriver.dll"
+          end
+          def binary_path
+            @binary_path ||= begin
+              possible_paths = [
+                "#{ENV['USERPROFILE']}\\Local Settings\\Application Data\\Google\\Chrome\\Application\\chrome.exe",
+                "#{ENV['USERPROFILE']}\\AppData\\Local\\Google\\Chrome\\Application\\chrome.exe",
+                "#{Platform.home}\\Local Settings\\Application Data\\Google\\Chrome\\Application\\chrome.exe",
+                "#{Platform.home}\\AppData\\Local\\Google\\Chrome\\Application\\chrome.exe",
+              ]
+              possible_paths.find { |f| File.exist?(f) } || possible_paths.first
+            end
+          end
+        end
+        class UnixLauncher < Launcher
+          def binary_path
+            @binary_path ||= "/usr/bin/google-chrome"
+          end
+        end
+        class MacOSXLauncher < UnixLauncher
+          def binary_path
+            @binary_path ||= "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
+          end
+        end
+      end # Launcher
+    end # Chrome
+  end # WebDriver
+end # Selenium

data/common/src/js/abstractcommandprocessor.js ADDED

@@ -0,0 +1,134 @@
+/** @license
+Copyright 2007-2009 WebDriver committers
+Copyright 2007-2009 Google Inc.
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+     http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+/**
+ * @fileoverview Base class for all WebDriver command processors.
+ * @author jmleyba@gmail.com (Jason Leyba)
+ */
+goog.provide('webdriver.AbstractCommandProcessor');
+goog.require('goog.Disposable');
+goog.require('goog.array');
+goog.require('goog.object');
+goog.require('webdriver.CommandName');
+goog.require('webdriver.Future');
+goog.require('webdriver.Response');
+goog.require('webdriver.WebElement');
+goog.require('webdriver.timing');
+/**
+ * Base class for all WebDriver command processors.
+ * @constructor
+ * @extends {goog.Disposable}
+ */
+webdriver.AbstractCommandProcessor = function() {
+  goog.Disposable.call(this);
+};
+goog.inherits(webdriver.AbstractCommandProcessor, goog.Disposable);
+/**
+ * Updates a {@code webdriver.Command} instance so that any parameters that
+ * are {@code webdriver.Future} values are converted to their asynchronously set
+ * values.
+ * @param {webdriver.Command} command The command object to modify.
+ * @throws If an attempt is made to fetch the value of a
+ *     {@code webdriver.Future} that hasn't been computed yet.
+ * @private
+ */
+webdriver.AbstractCommandProcessor.resolveFutureParams_ = function(
+    command) {
+  function getValue(obj) {
+    if (obj instanceof webdriver.Future) {
+      return obj.getValue();
+    } else if (goog.isFunction(obj) ||
+               obj instanceof webdriver.WebElement) {
+      return obj;
+    } else if (goog.isObject(obj)) {
+      goog.object.forEach(obj, function(value, key) {
+        if (value instanceof webdriver.Future) {
+          obj[key] = value.getValue();
+        }
+      });
+    }
+    return obj;
+  }
+  command.parameters = goog.array.map(command.parameters, function(param) {
+    if (goog.isArray(param)) {
+      return goog.array.map(param, getValue);
+    } else {
+      return getValue(param);
+    }
+  });
+};
+/**
+ * Executes a command.
+ * @param {webdriver.Command} command The command to execute.
+ */
+webdriver.AbstractCommandProcessor.prototype.execute = function(command) {
+  var driver = command.getDriver();
+  webdriver.AbstractCommandProcessor.resolveFutureParams_(command);
+  var parameters = command.getParameters();
+  switch (command.getName()) {
+    case webdriver.CommandName.SLEEP:
+      var ms = parameters[0];
+      webdriver.timing.setTimeout(function() {
+        command.setResponse(new webdriver.Response(
+            false, driver.getContext(), ms));
+      }, ms);
+      break;
+    case webdriver.CommandName.WAIT:
+    case webdriver.CommandName.FUNCTION:
+      try {
+        var fn = parameters[0];
+        var selfObj = parameters[1];
+        var args = parameters[2];
+        var result = fn.apply(selfObj, args);
+        command.setResponse(new webdriver.Response(
+            false, driver.getContext(), result));
+      } catch (ex) {
+        command.setResponse(new webdriver.Response(
+            true, driver.getContext(), null, ex));
+      }
+      break;
+    default:
+      try {
+        this.dispatchDriverCommand(command);
+      } catch (ex) {
+        command.setResponse(new webdriver.Response(
+            true, driver.getContext(), null, ex));
+      }
+      break;
+  }
+};
+/**
+ * Sends a command to be executed by a browser driver. This method must be
+ * implemented by each subclass.
+ * @param {webdriver.Command} command The command to execute.
+ * @protected
+ */
+webdriver.AbstractCommandProcessor.prototype.dispatchDriverCommand =
+    goog.abstractMethod;

data/common/src/js/asserts.js ADDED

@@ -0,0 +1,296 @@
+/** @license
+Copyright 2007-2009 WebDriver committers
+Copyright 2007-2009 Google Inc.
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+     http://www.apache.org/licenses/LICENSE-2.0
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+/**
+ * @fileoverview Assertion functions for use in webdriver test cases.
+ * @author jmleyba@gmail.com (Jason Leyba)
+ */
+goog.provide('webdriver.asserts');
+goog.require('goog.math.Coordinate');
+goog.require('goog.string');
+goog.require('webdriver.Future');
+/**
+ * @param {webdriver.Future|Object} obj The object to get the value form.
+ * @return {*} The value of the given object.
+ */
+webdriver.asserts.getValue_ = function(obj) {
+  return obj instanceof webdriver.Future ? obj.getValue() : obj;
+};
+/**
+ * Returns a string with the following format: "<$value> ($type)" where $value
+ * is the String representation of the {@code obj} and $type is its type.
+ * @param {*} obj The object to build a string for.
+ * @return {string} A string describing the given object.
+ */
+webdriver.asserts.objToString = function(obj) {
+  var value = webdriver.asserts.getValue_(obj);
+  var valueStr = goog.isDef(value) ? String(value) : 'undefined';
+  return '<' + valueStr + '> (' + goog.typeOf(value) + ')';
+};
+/**
+ * A class for determining if a value matches a defined criteria.
+ * @param {function} matchFn A function that takes a single argument and whether
+ *     that argument matches the criteria defined by this Matcher.
+ * @param {function} describeFn A function that returns a string describing the
+ *     criteria for this matcher.  The string returned by this function should
+ *     finish this sentence: "Expected to..."
+ * @constructor
+ */
+webdriver.asserts.Matcher = function(matchFn, describeFn) {
+  this.matches = matchFn;
+  this.describe = describeFn;
+};
+/**
+ * Factory method for a {@code webdriver.asserts.Matcher} that does a
+ * {@code ===} comparison between the expected and actual values.
+ * @param {*} expected The expected value.
+ * @return {webdriver.asserts.Matcher} An equality matcher.
+ */
+webdriver.asserts.Matcher.equals = function(expected) {
+  return new webdriver.asserts.Matcher(
+      function (actual) {
+        return webdriver.asserts.getValue_(expected) ===
+               webdriver.asserts.getValue_(actual);
+      },
+      function () {
+        return 'equal ' + webdriver.asserts.objToString(expected);
+      });
+};
+goog.exportSymbol('equals', webdriver.asserts.Matcher.equals);
+goog.exportSymbol('is', webdriver.asserts.Matcher.equals);
+/**
+ * Creates a {@code webdriver.asserts.Matcher} that tests if the actual
+ * value contains the expected value.
+ * @param {string} expected The string expected to be in the actual value.
+ * @return {webdriver.asserts.Matcher} A new matcher.
+ */
+webdriver.asserts.Matcher.contains = function(expected) {
+  return new webdriver.asserts.Matcher(
+      function (actual) {
+        var ev = webdriver.asserts.getValue_(expected);
+        var av = webdriver.asserts.getValue_(actual);
+        return goog.string.contains(av, ev);
+      },
+      function () {
+        return 'contain ' + webdriver.asserts.objToString(expected);
+      });
+};
+goog.exportSymbol('contains', webdriver.asserts.Matcher.contains);
+/**
+ * Creates a {@code webdriver.asserts.Matcher} that tests if the actual value
+ * matches the given regular expression.
+ * @param {RegEx} regex The expected regular expression.
+ * @return {webdriver.asserts.Matcher} A new matcher.
+ */
+webdriver.asserts.Matcher.matchesRegex = function(regex) {
+  if (!(regex instanceof RegExp)) {
+    throw new Error('IllegalArgument; must be a RegExp, but was: ' + regex +
+                    '(' + goog.typeOf(regex) + ')');
+  }
+  return new webdriver.asserts.Matcher(
+      function (actual) {
+        var av = webdriver.asserts.getValue_(actual);
+        return av.match(regex) != null;
+      },
+      function () {
+        return 'match regex ' + regex;
+      });
+};
+goog.exportSymbol('matchesRegex', webdriver.asserts.Matcher.matchesRegex);
+/**
+ * Creates a {@code webdriver.asserts.Matcher} that tests if the actual value
+ * starts with the given string.
+ * @param {string} expected The expected beginning of the tested string.
+ * @return {webdriver.asserts.Matcher} A new matcher.
+ */
+webdriver.asserts.Matcher.startsWith = function(expected) {
+  return new webdriver.asserts.Matcher(
+      function (actual) {
+        var ev = webdriver.asserts.getValue_(expected);
+        var av = webdriver.asserts.getValue_(actual);
+        return goog.string.startsWith(av, ev);
+      },
+      function () {
+        return 'start with ' + webdriver.asserts.objToString(expected);
+      });
+};
+goog.exportSymbol('startsWith', webdriver.asserts.Matcher.startsWith);
+/**
+ * Creates a {@code webdriver.asserts.Matcher} that tests if the actual value is
+ * the same location as the expected value.
+ * @param {goog.math.Coordinate} expected The expected location, or a future
+ *    whose pending result is the expected location.
+ * @return {webdriver.asserts.Matcher} A new matcher.
+ */
+webdriver.asserts.Matcher.isTheSameLocationAs = function(expected) {
+  return new webdriver.asserts.Matcher(
+      function (actual) {
+        var ev = webdriver.asserts.getValue_(expected);
+        var av = webdriver.asserts.getValue_(actual);
+        return goog.math.Coordinate.equals(ev, av);
+      },
+      function () {
+        return 'equal ' + webdriver.asserts.objToString(expected);
+      });
+};
+goog.exportSymbol('isTheSameLocationAs',
+                  webdriver.asserts.Matcher.isTheSameLocationAs);
+/**
+ * Verifies that that given value matches the provided {@code Matcher}. This
+ * method has two signatures based on the number of arguments:
+ * Two arguments:
+ *   assertThat(actualValue, matcher)
+ * Three arguments:
+ *   assertThat(failureMessage, actualValue, matcher)
+ * @param {string} failureMessage The message to include in the resulting error
+ *     if actualValue does not match matcher.
+ * @param {webdriver.Future|Object} The actual value to verify.
+ * @param {webdriver.asserts.Matcher} matcher The object to match the actual
+ *     value against.  If not an instanceof {@code webdriver.Matcher}, will
+ *     default to the matcher returned by the {@code webdriver.equals} factory
+ *     function.
+ */
+webdriver.asserts.assertThat = function(a, b, opt_c) {
+  var args = goog.array.slice(arguments, 0);
+  var message = args.length > 2 ? (args[0] + '\n') : '';
+  var future = args.length > 2 ? args[1] : args[0];
+  var matcher = args.length > 2 ? args[2] : args[1];
+  if (!(matcher instanceof webdriver.asserts.Matcher)) {
+    matcher = webdriver.asserts.Matcher.equals(matcher);
+  }
+  var doAssertion = function() {
+    if (!matcher.matches(future)) {
+      throw new Error(message +
+          'Expected to ' + matcher.describe() +
+          '\n  but was ' + webdriver.asserts.objToString(future));
+    }
+  };
+  if (future instanceof webdriver.Future) {
+    // Schedule a function with the Future's controlling driver so the value
+    // is verified after it has been set.
+    future.getDriver().callFunction(doAssertion);
+  } else {
+    doAssertion();
+  }
+};
+goog.exportSymbol('assertThat', webdriver.asserts.assertThat);
+// ----------------------------------------------------------------------------
+// Define some common xUnit paradigm assertion functions, but do not override
+// any pre-existing function (e.g. if the jsapi is being used with the jsunit
+// library.
+// ----------------------------------------------------------------------------
+goog.global.fail = goog.global.fail || function(opt_msg) {
+  var msg = 'Call to fail()';
+  if (opt_msg) {
+    msg += ': ' + opt_msg;
+  }
+  throw new Error(msg);
+};
+goog.global.assertEquals = goog.global.assertEquals || function(a, b, opt_c) {
+  var args = goog.array.slice(arguments, 0);
+  var msg = args.length > 2 ? args[0] : '';
+  var expected = args.length > 2 ? args[1] : args[0];
+  var actual = args.length > 2 ? args[2] : args[1];
+  if (expected !== actual) {
+    webdriver.asserts.assertThat(msg, actual, equals(expected));
+  }
+};
+goog.global.assertTrue = goog.global.assertTrue || function(a, opt_b) {
+  var args = goog.array.slice(arguments, 0);
+  if (args.length > 1) {
+    goog.global.assertEquals(args[0], true, args[1]);
+  } else {
+    goog.global.assertEquals(true, args[0]);
+  }
+};
+goog.global.assertFalse = goog.global.assertFalse || function(a, opt_b) {
+  var args = goog.array.slice(arguments, 0);
+  if (args.length > 1) {
+    goog.global.assertEquals(args[0], false, args[1]);
+  } else {
+    goog.global.assertEquals(false, args[0]);
+  }
+};
+/**
+ * Utility function for inverting a value.  If the input is a...
+ * <ul>
+ * <li>{@code webdriver.asserts.Matcher}, returns a new Matcher that inverts
+ * the result of the input</li>
+ * <li>{@code webdriver.Future}, returns a new Future whose result will be the
+ * inverse of hte input</li>
+ * <li>any other type of object, it will be converted to a boolean and
+ * inverted</li>
+ * </ul>
+ * @param {*) input The value to invert.
+ * @return {webdriver.asserts.Matcher|webdriver.Future|boolean} The inverted
+ *     value according to the rules defined above.
+ */
+webdriver.not = function(input) {
+  if (input instanceof webdriver.Future) {
+    var invertedFuture = new webdriver.Future(input.getDriver());
+    goog.events.listen(input, goog.events.EventType.CHANGE,
+        function() {
+          invertedFuture.setValue(!!!input.getValue());
+        });
+    return invertedFuture;
+  } else if (input instanceof webdriver.asserts.Matcher) {
+    return new webdriver.asserts.Matcher(
+        function (actual) {
+          return !input.matches(actual);
+        },
+        function () {
+          return 'not ' + input.describe();
+        });
+  } else {
+    return !!!value;
+  }
+};
+goog.exportSymbol('not', webdriver.not);