bbc-selenium-webdriver 1.17.0

data/lib/selenium/webdriver/support/select.rb

@@ -0,0 +1,293 @@
+module Selenium
+  module WebDriver
+    module Support
+      class Select
+
+        #
+        # @param [Element] element The select element to use
+        #
+
+        def initialize(element)
+          tag_name = element.tag_name
+
+          unless tag_name.downcase == "select"
+            raise ArgumentError, "unexpected tag name #{tag_name.inspect}"
+          end
+
+          @element = element
+          @multi   = ![nil, "false"].include?(element.attribute(:multiple))
+        end
+
+        #
+        # Does this select element support selecting multiple options?
+        #
+        # @return [Boolean]
+        #
+
+        def multiple?
+          @multi
+        end
+
+        #
+        # Get all options for this select element
+        #
+        # @return [Array<Element>]
+        #
+
+        def options
+          @element.find_elements :tag_name, 'option'
+        end
+
+        #
+        # Get all selected options for this select element
+        #
+        # @return [Array<Element>]
+        #
+
+        def selected_options
+          options.select { |e| e.selected? }
+        end
+
+        #
+        # Get the first selected option in this select element
+        #
+        # @raise [Error::NoSuchElementError] if no options are selected
+        # @return [Element]
+        #
+
+        def first_selected_option
+          option = options.find { |e| e.selected? }
+          option or raise Error::NoSuchElementError, 'no options are selected'
+        end
+
+        #
+        # Select options by visible text, index or value.
+        #
+        # When selecting by :text, selects options that display text matching the argument. That is, when given "Bar" this
+        # would select an option like:
+        #
+        #     <option value="foo">Bar</option>
+        #
+        # When slecting by :value, selects all options that have a value matching the argument. That is, when given "foo" this
+        # would select an option like:
+        #
+        #     <option value="foo">Bar</option>
+        #
+        # When selecting by :index, selects the option at the given index. This is done by examining the "index" attribute of an
+        # element, and not merely by counting.
+        #
+        # @param [:text, :index, :value] how How to find the option
+        # @param [String] what What value to find the option by.
+        #
+
+        def select_by(how, what)
+          case how
+          when :text
+            select_by_text what
+          when :index
+            select_by_index what
+          when :value
+            select_by_value what
+          else
+            raise ArgumentError, "can't select options by #{how.inspect}"
+          end
+        end
+
+        #
+        # Deselect options by visible text, index or value.
+        #
+        # @param [:text, :index, :value] how How to find the option
+        # @param [String] what What value to find the option by.
+        #
+        # @see Select#select_by
+        #
+
+        def deselect_by(how, what)
+          case how
+          when :text
+            deselect_by_text what
+          when :value
+            deselect_by_value what
+          when :index
+            deselect_by_index what
+          else
+            raise ArgumentError, "can't deselect options by #{how.inspect}"
+          end
+        end
+
+        #
+        # Select all unselected options. Only valid if the element supports multiple selections.
+        #
+        # @raise [Error::UnsupportedOperationError] if the element does not support multiple selections.
+        #
+
+        def select_all
+          unless multiple?
+            raise Error::UnsupportedOperationError, 'you may only select all options of a multi-select'
+          end
+
+          options.each { |e| select_option e }
+        end
+
+        #
+        # Deselect all selected options. Only valid if the element supports multiple selections.
+        #
+        # @raise [Error::UnsupportedOperationError] if the element does not support multiple selections.
+        #
+
+        def deselect_all
+          unless multiple?
+            raise Error::UnsupportedOperationError, 'you may only deselect all options of a multi-select'
+          end
+
+          options.each { |e| deselect_option e }
+        end
+
+        private
+
+        def select_by_text(text)
+          opts = find_by_text text
+
+          if opts.empty?
+            raise Error::NoSuchElementError, "cannot locate element with text: #{text.inspect}"
+          end
+
+          select_options opts
+        end
+
+        def select_by_index(index)
+          opts = find_by_index index
+
+          if opts.empty?
+            raise Error::NoSuchElementError, "cannot locate element with index: #{index.inspect}"
+          end
+
+          select_options opts
+        end
+
+        def select_by_value(value)
+          opts = find_by_value value
+
+          if opts.empty?
+            raise Error::NoSuchElementError, "cannot locate option with value: #{value.inspect}"
+          end
+
+          select_options opts
+        end
+
+        def deselect_by_text(text)
+          opts = find_by_text text
+
+          if opts.empty?
+            raise Error::NoSuchElementError, "cannot locate element with text: #{text.inspect}"
+          end
+
+          deselect_options opts
+        end
+
+        def deselect_by_value(value)
+          opts = find_by_value value
+
+          if opts.empty?
+            raise Error::NoSuchElementError, "cannot locate option with value: #{value.inspect}"
+          end
+
+          deselect_options opts
+        end
+
+        def deselect_by_index(index)
+          opts = find_by_index index
+
+          if opts.empty?
+            raise Error::NoSuchElementError, "cannot locate option with index: #{index}"
+          end
+
+          deselect_options opts
+        end
+
+        private
+
+        def select_option(option)
+          option.click unless option.selected?
+        end
+
+        def deselect_option(option)
+          option.click if option.selected?
+        end
+
+        def select_options(opts)
+          if multiple?
+            opts.each { |o| select_option o }
+          else
+            select_option opts.first
+          end
+        end
+
+        def deselect_options(opts)
+          if multiple?
+            opts.each { |o| deselect_option o }
+          else
+            deselect_option opts.first
+          end
+        end
+
+        def find_by_text(text)
+          xpath = ".//option[normalize-space(.) = #{Escaper.escape text}]"
+          opts = @element.find_elements(:xpath, xpath)
+
+          if opts.empty? && text =~ /\s+/
+            longest_word = text.split(/\s+/).max_by { |item| item.length }
+
+            if longest_word.empty?
+              candidates = options
+            else
+              xpath = ".//option[contains(., #{Escaper.escape longest_word})]"
+              candidates = @element.find_elements(:xpath, xpath)
+            end
+
+            if multiple?
+              candidates.select { |option| text == option.text }
+            else
+              Array(candidates.find { |option| text == option.text })
+            end
+          else
+            opts
+          end
+        end
+
+        def find_by_index(index)
+          index = index.to_s
+          options.select { |option| option.attribute(:index) == index }
+        end
+
+        def find_by_value(value)
+          @element.find_elements(:xpath, ".//option[@value = #{Escaper.escape value}]")
+        end
+
+        #
+        # @api private
+        #
+
+        module Escaper
+          def self.escape(str)
+            if str.include?('"') && str.include?("'")
+              parts = str.split('"', -1).map { |part| %{"#{part}"} }
+
+              quoted = parts.join(%{, '"', }).
+                             gsub(/^"", |, ""$/, '')
+
+              "concat(#{quoted})"
+            elsif str.include?('"')
+              # escape string with just a quote into being single quoted: f"oo -> 'f"oo'
+              "'#{str}'"
+            else
+              # otherwise return the quoted string
+              %{"#{str}"}
+            end
+          end
+        end # Escaper
+
+      end # Select
+    end
+  end
+end

data/spec/integration/selenium/client/api/backward_compatible_api_spec.rb

@@ -0,0 +1,22 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Backward Compatible API" do
+  it "provides legacy driver methods" do
+		page.open "http://localhost:4444/selenium-server/tests/html/test_click_page1.html"
+
+    page.get_title.should eql("Click Page 1")
+		page.get_text("link").index("Click here for next page").should_not be_nil
+
+		links = page.get_all_links
+		links.length.should > 3
+		links[3].should eql("linkToAnchorOnThisPage")
+
+		page.click "link"
+		page.wait_for_page_to_load 5000
+		page.get_location.should =~ %r"/selenium-server/tests/html/test_click_page2.html"
+
+		page.click "previousPage"
+		page.wait_for_page_to_load 5000
+		page.get_location.should =~ %r"/selenium-server/tests/html/test_click_page1.html"
+  end
+end

data/spec/integration/selenium/client/api/browser_xpath_library_spec.rb

@@ -0,0 +1,17 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Browser XPath Library" do
+
+  it "can be set to default" do
+    page.browser_xpath_library = :default
+  end
+
+  it "can be set to ajaxslt" do
+    page.browser_xpath_library = :ajaxslt
+  end
+
+  it "can be set to javascript-xpath" do
+    page.browser_xpath_library = :'javascript-xpath'
+  end
+
+end

data/spec/integration/selenium/client/api/click_spec.rb

@@ -0,0 +1,39 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Click Instrumentation" do
+  it "clicks" do
+    page.open "http://localhost:4444/selenium-server/tests/html/test_click_page1.html"
+    page.text_content("link").should eql("Click here for next page")
+
+    page.click "link", :wait_for => :page
+    page.title.should eql("Click Page Target")
+
+    page.click "previousPage", :wait_for => :page
+    page.title.should eql("Click Page 1")
+
+    page.click "linkWithEnclosedImage", :wait_for => :page
+    page.title.should eql("Click Page Target")
+
+    page.click "previousPage", :wait_for => :page
+    page.click "enclosedImage", :wait_for => :page
+    page.title.should eql("Click Page Target")
+
+    page.click "previousPage", :wait_for => :page
+    page.click "extraEnclosedImage", :wait_for => :page
+    page.title.should eql("Click Page Target")
+
+    page.click "previousPage", :wait_for => :page
+    page.click "linkToAnchorOnThisPage"
+    page.title.should eql("Click Page 1")
+
+    page.click "linkWithOnclickReturnsFalse"
+    page.title.should eql("Click Page 1")
+  end
+
+  it "double clicks" do
+    page.open "http://localhost:4444/selenium-server/tests/html/test_click_page1.html"
+    page.double_click "doubleClickable"
+
+    page.get_alert.should eql("double clicked!")
+  end
+end

data/spec/integration/selenium/client/api/cookie_spec.rb

@@ -0,0 +1,39 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Cookie Handling" do
+  it "deletes all cookies" do
+    page.open "http://localhost:4444/selenium-server/tests/html/path1/cookie1.html"
+    page.delete_all_visible_cookies
+
+    page.cookies.should be_empty
+
+    page.open "http://localhost:4444/selenium-server/tests/html/path2/cookie2.html"
+    page.delete_all_visible_cookies
+
+    page.cookies.should be_empty
+  end
+
+  it "can set cookies" do
+    page.open "http://localhost:4444/selenium-server/tests/html/path1/cookie1.html"
+    page.create_cookie "addedCookieForPath1=new value1"
+    page.create_cookie "addedCookieForPath2=new value2", :path => "/selenium-server/tests/html/path2/", :max_age => 60
+    page.open "http://localhost:4444/selenium-server/tests/html/path1/cookie1.html"
+    page.cookies.should =~ /addedCookieForPath1=new value1/
+
+    page.cookie?("addedCookieForPath1").should be_true
+    page.cookie("addedCookieForPath1").should eql("new value1")
+    page.cookie?("testCookie").should be_false
+    page.cookie?("addedCookieForPath2").should be_false
+
+    page.delete_cookie "addedCookieForPath1", "/selenium-server/tests/html/path1/"
+    page.cookies.should be_empty
+
+    page.open "http://localhost:4444/selenium-server/tests/html/path2/cookie2.html"
+    page.cookie("addedCookieForPath2").should eql("new value2")
+    page.cookie?("addedCookieForPath1").should be_false
+
+    page.delete_cookie "addedCookieForPath2", "/selenium-server/tests/html/path2/"
+    page.delete_cookie "addedCookieForPath2"
+    page.cookies.should be_empty
+  end
+end

data/spec/integration/selenium/client/api/element_spec.rb

@@ -0,0 +1,14 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Element API" do
+  it "can detect element presence" do
+    page.open "http://localhost:4444/selenium-server/tests/html/test_element_present.html"
+    page.element?('aLink').should be_true
+
+    page.click 'removeLinkAfterAWhile', :wait_for => :no_element, :element => "aLink"
+    page.element?('aLink').should be_false
+
+    page.click 'addLinkAfterAWhile', :wait_for => :element, :element => "aLink"
+    page.element?('aLink').should be_true
+  end
+end

data/spec/integration/selenium/client/api/highlight_located_element_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Highlight Located Element" do
+  it "can be enabled and disabled on the fly" do
+    page.open "http://localhost:4567/jquery.html"
+    page.execution_delay = 1000
+    page.highlight_located_element = true
+    begin
+      page.text("calculator-result").should be_empty
+
+      page.type "calculator-expression", "2 + 2"
+      page.click "calculator-button" , :wait_for => :ajax, :javascript_framework => :jquery
+
+      page.value("calculator-result").should eql("4")
+    ensure
+      page.highlight_located_element = false
+    end
+  end
+end