browserstack-webdriver 0.0.1

data/lib/selenium/webdriver/common/driver_extensions/has_remote_status.rb

@@ -0,0 +1,13 @@
+module Selenium
+  module WebDriver
+    module DriverExtensions
+      module HasRemoteStatus
+
+        def remote_status
+          @bridge.status
+        end
+
+      end
+    end
+  end
+end

data/lib/selenium/webdriver/common/driver_extensions/has_session_id.rb

@@ -0,0 +1,22 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    #
+
+    module DriverExtensions
+      module HasSessionId
+
+        #
+        # @return [String] the session id
+        # @api public
+        #
+
+        def session_id
+          @bridge.session_id
+        end
+      end # HasSessionId
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/driver_extensions/has_touch_screen.rb

@@ -0,0 +1,19 @@
+module Selenium
+  module WebDriver
+    module DriverExtensions
+
+      module HasTouchScreen
+        def touch
+          TouchActionBuilder.new mouse, keyboard, touch_screen
+        end
+
+        private
+
+        def touch_screen
+          TouchScreen.new @bridge
+        end
+      end
+
+    end
+  end
+end

data/lib/selenium/webdriver/common/driver_extensions/has_web_storage.rb

@@ -0,0 +1,22 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    #
+
+    module DriverExtensions
+      module HasWebStorage
+
+        def local_storage
+          HTML5::LocalStorage.new @bridge
+        end
+
+        def session_storage
+          HTML5::SessionStorage.new @bridge
+        end
+
+      end # HasWebStorage
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/driver_extensions/rotatable.rb

@@ -0,0 +1,45 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    #
+
+    module DriverExtensions
+      module Rotatable
+
+        ORIENTATIONS = [:landscape, :portrait]
+
+        #
+        # Change the screen orientation
+        #
+        # @param [:landscape, :portrait] Orientation
+        #
+        # @api public
+        #
+
+        def rotation=(orientation)
+          unless ORIENTATIONS.include?(orientation)
+            raise ArgumentError, "expected #{ORIENTATIONS.inspect}, got #{orientation.inspect}"
+          end
+
+          bridge.setScreenOrientation(orientation.to_s.upcase)
+        end
+        alias_method :rotate, :rotation=
+
+        #
+        # Get the current screen orientation
+        #
+        # @return [:landscape, :portrait] orientation
+        #
+        # @api public
+        #
+
+        def orientation
+          bridge.getScreenOrientation.to_sym.downcase
+        end
+
+      end # Rotatable
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/driver_extensions/takes_screenshot.rb

@@ -0,0 +1,43 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    #
+
+    module DriverExtensions
+      module TakesScreenshot
+
+        #
+        # Save a PNG screenshot to the given path
+        #
+        # @api public
+        #
+
+        def save_screenshot(png_path)
+          File.open(png_path, 'wb') { |f| f << screenshot_as(:png) }
+        end
+
+        #
+        # Return a PNG screenshot in the given format as a string
+        #
+        # @param [:base64, :png] format
+        # @return String screenshot
+        #
+        # @api public
+
+        def screenshot_as(format)
+          case format
+          when :base64
+            bridge.getScreenshot
+          when :png
+            bridge.getScreenshot.unpack("m")[0]
+          else
+            raise Error::UnsupportedOperationError, "unsupported format: #{format.inspect}"
+          end
+        end
+
+      end # TakesScreenshot
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/driver_extensions/uploads_files.rb

@@ -0,0 +1,46 @@
+module Selenium
+  module WebDriver
+
+    #
+    # @api private
+    #
+
+    module DriverExtensions
+      module UploadsFiles
+
+        #
+        # Set the file detector to pass local files to a remote WebDriver.
+        #
+        # The detector is an object that responds to #call, and when called
+        # will determine if the given string represents a file. If it does,
+        # the path to the file on the local file system should be returned,
+        # otherwise nil or false.
+        #
+        # Example:
+        #
+        #     driver = Selenium::WebDriver.for :remote
+        #     driver.file_detector = lambda do |args|
+        #        # args => ["/path/to/file"]
+        #        str = args.first.to_s
+        #        str if File.exist?(str)
+        #     end
+        #
+        #     driver.find_element(:id => "upload").send_keys "/path/to/file"
+        #
+        # By default, no file detection is performed.
+        #
+        # @api public
+        #
+
+        def file_detector=(detector)
+          unless detector.nil? or detector.respond_to? :call
+            raise ArgumentError, "detector must respond to #call"
+          end
+
+          bridge.file_detector = detector
+        end
+
+      end # UploadsFiles
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

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

@@ -0,0 +1,293 @@
+module Selenium
+  module WebDriver
+    class Element
+      include SearchContext
+
+      #
+      # Creates a new Element
+      #
+      # @api private
+      #
+
+      def initialize(bridge, id)
+        @bridge, @id = bridge, id
+      end
+
+      def inspect
+        '#<%s:0x%x id=%s>' % [self.class, hash*2, @id.inspect]
+      end
+
+      def ==(other)
+        other.kind_of?(self.class) && bridge.elementEquals(self, other)
+      end
+      alias_method :eql?, :==
+
+      def hash
+        @id.hash ^ @bridge.hash
+      end
+
+      #
+      # Click this element. If this causes a new page to load, this method will
+      # attempt to block until the page has loaded.  At this point, you should
+      # discard all references to this element and any further operations
+      # performed on this element will raise a StaleElementReferenceError
+      # unless you know that the element and the page will still be present. If
+      # click() causes a new page to be loaded via an event or is done by
+      # sending a native event then the method will *not* wait for it to be
+      # loaded and the caller should verify that a new page has been loaded.
+      #
+      # There are some preconditions for an element to be clicked.  The element
+      # must be visible and it must have a height and width greater then 0.
+      #
+      # Equivalent to:
+      #   driver.action.click(element)
+      #
+      # @example Click on a button
+      #
+      #    driver.find_element(:tag_name, "button").click
+      #
+      # @raise [StaleElementReferenceError] if the element no longer exists as
+      #  defined
+      #
+
+      def click
+        bridge.clickElement @id
+      end
+
+      #
+      # Get the tag name of the element.
+      #
+      # @example Get the tagname of an INPUT element(returns "input")
+      #
+      #    driver.find_element(:xpath, "//input").tag_name
+      #
+      # @return [String] The tag name of this element.
+      #
+
+      def tag_name
+        bridge.getElementTagName @id
+      end
+
+      #
+      # Get the value of a the given attribute of the element. Will return the current value, even if
+      # this has been modified after the page has been loaded. More exactly, this method will return
+      # the value of the given attribute, unless that attribute is not present, in which case the
+      # value of the property with the same name is returned. If neither value is set, nil is
+      # returned. The "style" attribute is converted as best can be to a text representation with a
+      # trailing semi-colon. The following are deemed to be "boolean" attributes, and will
+      # return either "true" or "false":
+      #
+      # async, autofocus, autoplay, checked, compact, complete, controls, declare, defaultchecked,
+      # defaultselected, defer, disabled, draggable, ended, formnovalidate, hidden, indeterminate,
+      # iscontenteditable, ismap, itemscope, loop, multiple, muted, nohref, noresize, noshade, novalidate,
+      # nowrap, open, paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+      # selected, spellcheck, truespeed, willvalidate
+      #
+      # Finally, the following commonly mis-capitalized attribute/property names are evaluated as
+      # expected:
+      #
+      # class, readonly
+      #
+      # @param [String]
+      #   attribute name
+      # @return [String,nil]
+      #   attribute value
+      #
+
+      def attribute(name)
+        bridge.getElementAttribute @id, name
+      end
+
+      #
+      # Get the text content of this element
+      #
+      # @return [String]
+      #
+
+      def text
+        bridge.getElementText @id
+      end
+
+      #
+      # Send keystrokes to this element
+      #
+      # @param [String, Symbol, Array]
+      #
+      # Examples:
+      #
+      #     element.send_keys "foo"                     #=> value: 'foo'
+      #     element.send_keys "tet", :arrow_left, "s"   #=> value: 'test'
+      #     element.send_keys [:control, 'a'], :space   #=> value: ' '
+      #
+      # @see Keys::KEYS
+      #
+
+      def send_keys(*args)
+        bridge.sendKeysToElement @id, Keys.encode(args)
+      end
+      alias_method :send_key, :send_keys
+
+      #
+      # If this element is a text entry element, this will clear the value. Has no effect on other
+      # elements. Text entry elements are INPUT and TEXTAREA elements.
+      #
+      # Note that the events fired by this event may not be as you'd expect.  In particular, we don't
+      # fire any keyboard or mouse events.  If you want to ensure keyboard events are
+      # fired, consider using #send_keys with the backspace key. To ensure you get a change event, 
+      # consider following with a call to #send_keys with the tab key.
+      #
+
+      def clear
+        bridge.clearElement @id
+      end
+
+      #
+      # Is the element enabled?
+      #
+      # @return [Boolean]
+      #
+
+      def enabled?
+        bridge.isElementEnabled @id
+      end
+
+      #
+      # Is the element selected?
+      #
+      # @return [Boolean]
+      #
+
+      def selected?
+        bridge.isElementSelected @id
+      end
+
+      #
+      # Is the element displayed?
+      #
+      # @return [Boolean]
+      #
+
+      def displayed?
+        bridge.isElementDisplayed @id
+      end
+
+      #
+      # Submit this element
+      #
+
+      def submit
+        bridge.submitElement @id
+      end
+
+      #
+      # Get the value of the given CSS property
+      #
+      # Note that shorthand CSS properties (e.g. background, font, border, border-top, margin,
+      # margin-top, padding, padding-top, list-style, outline, pause, cue) are not returned,
+      # in accordance with the DOM CSS2 specification - you should directly access the longhand
+      # properties (e.g. background-color) to access the desired values.
+      #
+      # @see http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-CSSStyleDeclaration
+      #
+
+      def css_value(prop)
+        bridge.getElementValueOfCssProperty @id, prop
+      end
+      alias_method :style, :css_value
+
+      #
+      # Get the location of this element.
+      #
+      # @return [WebDriver::Point]
+      #
+
+      def location
+        bridge.getElementLocation @id
+      end
+
+      #
+      # Determine an element's location on the screen once it has been scrolled into view.
+      #
+      # @return [WebDriver::Point]
+      #
+
+      def location_once_scrolled_into_view
+        bridge.getElementLocationOnceScrolledIntoView @id
+      end
+
+      #
+      # Get the size of this element
+      #
+      # @return [WebDriver::Dimension]
+      #
+
+      def size
+        bridge.getElementSize @id
+      end
+
+      #-------------------------------- sugar  --------------------------------
+
+      #
+      #   element.first(:id, 'foo')
+      #
+
+      alias_method :first, :find_element
+
+      #
+      #   element.all(:class, 'bar')
+      #
+
+      alias_method :all, :find_elements
+
+      #
+      #   element['class'] or element[:class] #=> "someclass"
+      #
+      alias_method :[], :attribute
+
+      #
+      # for SearchContext and execute_script
+      #
+      # @api private
+      #
+
+      def ref
+        @id
+      end
+
+      #
+      # Convert to a WebElement JSON Object for transmission over the wire.
+      # @see http://code.google.com/p/selenium/wiki/JsonWireProtocol#Basic_Concepts_And_Terms
+      #
+      # @api private
+      #
+
+      def to_json(*args)
+        WebDriver.json_dump as_json
+      end
+
+      #
+      # For Rails 3 - http://jonathanjulian.com/2010/04/rails-to_json-or-as_json/
+      #
+      # @api private
+      #
+
+      def as_json(opts = nil)
+        { :ELEMENT => @id }
+      end
+
+      private
+
+      def bridge
+        @bridge
+      end
+
+      def selectable?
+        tn = tag_name.downcase
+        type = attribute(:type).to_s.downcase
+
+        tn == "option" || (tn == "input" && %w[radio checkbox].include?(type))
+      end
+
+    end # Element
+  end # WebDriver
+end # Selenium