browserstack-webdriver 0.0.1

data/lib/selenium/webdriver/common/error.rb

@@ -0,0 +1,207 @@
+module Selenium
+  module WebDriver
+    module Error
+
+      class WebDriverError < StandardError; end
+      class UnsupportedOperationError < WebDriverError; end
+
+      class IndexOutOfBoundsError < WebDriverError; end          # 1
+      class NoCollectionError < WebDriverError; end              # 2
+      class NoStringError < WebDriverError; end                  # 3
+      class NoStringLengthError < WebDriverError; end            # 4
+      class NoStringWrapperError < WebDriverError; end           # 5
+      class NoSuchDriverError < WebDriverError; end              # 6
+
+      #
+      # An element could not be located on the page using the given search
+      # parameters.
+      #
+
+      class NoSuchElementError < WebDriverError; end             # 7
+
+      #
+      # A request to switch to a frame could not be satisfied because the
+      # frame could not be found.
+      #
+
+      class NoSuchFrameError < WebDriverError; end               # 8
+      class UnknownCommandError < WebDriverError; end            # 9
+
+
+      #
+      # Indicates that a reference to an element is now "stale" - the element
+      # no longer appears in the DOM of the page.
+      #
+
+      class StaleElementReferenceError < WebDriverError; end     # 10
+
+      #
+      # Raised to indicate that although an element is present on the DOM,
+      # it is not visible, and so is not able to be interacted with.
+      #
+
+      class ElementNotVisibleError < WebDriverError; end         # 11
+
+      #
+      # Raised when an interaction could not be performed because the element
+      # is in an invalid state (e.g. attempting to click a disabled element).
+      #
+
+      class InvalidElementStateError < WebDriverError; end       # 12
+
+      #
+      # An unknown server-side error occurred while processing the command.
+      #
+
+      class UnknownError < WebDriverError; end                   # 13
+      class ExpectedError < WebDriverError; end                  # 14
+
+      #
+      # An attempt was made to select an element that cannot be selected.
+      #
+
+      class ElementNotSelectableError < WebDriverError; end      # 15
+      class NoSuchDocumentError < WebDriverError; end            # 16
+
+      #
+      # An error occurred while executing user supplied JavaScript.
+      #
+
+      class JavascriptError < WebDriverError; end                # 17
+      class NoScriptResultError < WebDriverError; end            # 18
+
+      #
+      # An error occurred while searching for an element by XPath.
+      #
+
+      class XPathLookupError < WebDriverError; end               # 19
+      class NoSuchCollectionError < WebDriverError; end          # 20
+
+      #
+      # Raised when a command does not complete in enough time.
+      #
+
+      class TimeOutError < WebDriverError; end                   # 21
+      class NullPointerError < WebDriverError; end               # 22
+      class NoSuchWindowError < WebDriverError; end              # 23
+
+      #
+      # Raised when attempting to add a cookie under a different domain than
+      # the current URL.
+      #
+
+      class InvalidCookieDomainError < WebDriverError; end       # 24
+
+      #
+      # Raised when a driver fails to set a cookie.
+      #
+
+      class UnableToSetCookieError < WebDriverError; end         # 25
+
+      #
+      # Raised when an alert dialog is present that has not been dealt with.
+      #
+      class UnhandledAlertError < WebDriverError; end            # 26
+
+      #
+      # Indicates that a user has tried to access an alert when one is not present.
+      #
+
+      class NoAlertPresentError < WebDriverError; end            # 27
+
+      #
+      # A script did not complete before its timeout expired.
+      #
+
+      class ScriptTimeOutError < WebDriverError; end             # 28
+
+      #
+      # The coordinates provided to an interactions operation are invalid.
+      #
+
+      class InvalidElementCoordinatesError < WebDriverError; end # 29
+
+      #
+      # Indicates that IME support is not available. This exception is rasied
+      # for every IME-related method call if IME support is not available on
+      # the machine.
+      #
+
+      class IMENotAvailableError < WebDriverError; end           # 30
+
+      #
+      # Indicates that activating an IME engine has failed.
+      #
+
+      class IMEEngineActivationFailedError < WebDriverError; end # 31
+
+      #
+      # Argument was an invalid selector (e.g. XPath/CSS).
+      #
+
+      class InvalidSelectorError < WebDriverError; end           # 32
+                                                                 # 33
+
+      #
+      # Indicates that the target provided to the actions #move method is
+      # invalid, e.g. outside of the bounds of the window.
+      #
+
+      class MoveTargetOutOfBoundsError < WebDriverError; end     # 34
+
+      # @api private
+      Errors = [
+        IndexOutOfBoundsError,          # 1
+        NoCollectionError,              # 2
+        NoStringError,                  # 3
+        NoStringLengthError,            # 4
+        NoStringWrapperError,           # 5
+        NoSuchDriverError,              # 6
+        NoSuchElementError,             # 7
+        NoSuchFrameError,               # 8
+        UnknownCommandError,            # 9
+        StaleElementReferenceError,     # 10
+        ElementNotVisibleError,         # 11
+        InvalidElementStateError,       # 12
+        UnknownError,                   # 13
+        ExpectedError,                  # 14
+        ElementNotSelectableError,      # 15
+        NoSuchDocumentError,            # 16
+        JavascriptError,                # 17
+        NoScriptResultError,            # 18
+        XPathLookupError,               # 19
+        NoSuchCollectionError,          # 20
+        TimeOutError,                   # 21
+        NullPointerError,               # 22
+        NoSuchWindowError,              # 23
+        InvalidCookieDomainError,       # 24
+        UnableToSetCookieError,         # 25
+        UnhandledAlertError,            # 26
+        NoAlertPresentError,            # 27
+        ScriptTimeOutError,             # 28
+        InvalidElementCoordinatesError, # 29
+        IMENotAvailableError,           # 30
+        IMEEngineActivationFailedError, # 31
+        InvalidSelectorError,           # 32
+        nil,                            # 33
+        MoveTargetOutOfBoundsError      # 34
+      ]
+
+      # aliased for backwards compatibility
+      ObsoleteElementError      = StaleElementReferenceError
+      UnhandledError            = UnknownError
+      UnexpectedJavascriptError = JavascriptError
+      NoAlertOpenError          = NoAlertPresentError
+      ElementNotDisplayedError  = ElementNotVisibleError
+
+      class << self
+        def for_code(code)
+          return if [nil, 0].include? code
+
+          Errors[code - 1] || WebDriverError
+        end
+      end
+
+    end # Error
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/file_reaper.rb

@@ -0,0 +1,47 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    #
+
+    module FileReaper
+
+      class << self
+        def reap=(bool)
+          @reap = bool
+        end
+
+        def reap?
+          @reap = true unless defined?(@reap)
+          !!@reap
+        end
+
+        def tmp_files
+          @tmp_files ||= []
+        end
+
+        def <<(file)
+          tmp_files << file
+        end
+
+        def reap(file)
+          return unless reap?
+
+          unless tmp_files.include?(file)
+            raise Error::WebDriverError, "file not added for reaping: #{file.inspect}"
+          end
+
+          FileUtils.rm_rf tmp_files.delete(file)
+        end
+
+        def reap!
+          tmp_files.each { |file| FileUtils.rm_rf(file) } if reap?
+        end
+      end
+
+      Platform.exit_hook { reap! }
+
+    end # FileReaper
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/html5/local_storage.rb

@@ -0,0 +1,42 @@
+module Selenium
+  module WebDriver
+    module HTML5
+
+      class LocalStorage
+        include SharedWebStorage
+
+        #
+        # @api private
+        #
+        def initialize(bridge)
+          @bridge = bridge
+        end
+
+        def [](key)
+          @bridge.getLocalStorageItem key
+        end
+
+        def []=(key, value)
+          @bridge.setLocalStorageItem key, value
+        end
+
+        def delete(key)
+          @bridge.removeLocalStorageItem key
+        end
+
+        def clear
+          @bridge.clearLocalStorage
+        end
+
+        def size
+          @bridge.getLocalStorageSize
+        end
+
+        def keys
+          @bridge.getLocalStorageKeys.reverse
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/common/html5/session_storage.rb

@@ -0,0 +1,44 @@
+module Selenium
+  module WebDriver
+    module HTML5
+
+      class SessionStorage
+        include Enumerable
+        include SharedWebStorage
+
+        def [](key)
+          @bridge.getSessionStorageItem key
+        end
+
+        def []=(key, value)
+          @bridge.setSessionStorageItem key, value
+        end
+
+        def delete(key)
+          @bridge.removeSessionStorageItem key
+        end
+
+        def clear
+          @bridge.clearSessionStorage
+        end
+
+        def size
+          @bridge.getSessionStorageSize
+        end
+
+        def keys
+          @bridge.getSessionStorageKeys.reverse
+        end
+
+        #
+        # @api private
+        #
+
+        def initialize(bridge)
+          @bridge = bridge
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/common/html5/shared_web_storage.rb

@@ -0,0 +1,42 @@
+module Selenium
+  module WebDriver
+    module HTML5
+
+      module SharedWebStorage
+        include Enumerable
+
+        def key?(key)
+          keys.include? key
+        end
+        alias_method :member?, :key?
+        alias_method :has_key?, :key?
+
+        def fetch(key, &blk)
+          if self.key? key
+            return self[key]
+          end
+
+          if block_given?
+            yield key
+          else
+            # should be KeyError, but it's 1.9-specific
+            raise IndexError, "missing key #{key.inspect}" 
+          end
+        end
+
+        def empty?
+          size == 0
+        end
+
+        def each(&blk)
+          return enum_for(:each) unless block_given?
+
+          keys.each do |k|
+            yield k, self[k]
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/common/json_helper.rb

@@ -0,0 +1,34 @@
+module Selenium
+  module WebDriver
+    module JsonHelper
+
+      # ActiveSupport may define Object#load, so we can't use MultiJson.respond_to? here
+      sm = MultiJson.singleton_methods.map { |e| e.to_sym }
+
+      if sm.include? :load
+        # @api private
+        def json_load(obj)
+          MultiJson.load(obj)
+        end
+      else
+        # @api private
+        def json_load(obj)
+          MultiJson.decode(obj)
+        end
+      end
+
+      if sm.include? :dump
+        # @api private
+        def json_dump(obj)
+          MultiJson.dump(obj)
+        end
+      else
+        # @api private
+        def json_dump(obj)
+          MultiJson.encode(obj)
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/common/keyboard.rb

@@ -0,0 +1,55 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    # @see ActionBuilder
+
+    class Keyboard
+
+      def initialize(bridge)
+        @bridge = bridge
+      end
+
+      def send_keys(*keys)
+        @bridge.sendKeysToActiveElement Keys.encode(keys)
+      end
+
+      #
+      # Press a modifier key
+      #
+      # @see Selenium::WebDriver::Keys
+      #
+
+      def press(key)
+        assert_modifier key
+
+        @bridge.sendKeysToActiveElement Keys.encode([key])
+      end
+
+      #
+      # Release a modifier key
+      #
+      # @see Selenium::WebDriver::Keys
+      #
+
+      def release(key)
+        assert_modifier key
+
+        @bridge.sendKeysToActiveElement Keys.encode([key])
+      end
+
+      private
+
+      MODIFIERS = [:control, :shift, :alt, :command, :meta]
+
+      def assert_modifier(key)
+        unless MODIFIERS.include? key
+          raise ArgumentError,
+            "#{key.inspect} is not a modifier key, expected one of #{MODIFIERS.inspect}"
+        end
+      end
+
+    end # Keyboard
+  end # WebDriver
+end  # Selenium