browserstack-webdriver 0.0.1

data/ruby.iml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/lib" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/spec" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="ruby-1.9" jdkType="RUBY_SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>
+

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/org/openqa/selenium/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/org/openqa/selenium/tests/html/test_click_page2.html"
+
+		page.click "previousPage"
+		page.wait_for_page_to_load 5000
+		page.get_location.should =~ %r"/selenium-server/org/openqa/selenium/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/org/openqa/selenium/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/org/openqa/selenium/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/org/openqa/selenium/tests/html/path1/cookie1.html"
+    page.delete_all_visible_cookies
+
+    page.cookies.should be_empty
+
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/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/org/openqa/selenium/tests/html/path1/cookie1.html"
+    page.create_cookie "addedCookieForPath1=new value1"
+    page.create_cookie "addedCookieForPath2=new value2", :path => "/selenium-server/org/openqa/selenium/tests/html/path2/", :max_age => 60
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/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/org/openqa/selenium/tests/html/path1/"
+    page.cookies.should be_empty
+
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/path2/cookie2.html"
+    page.cookie("addedCookieForPath2").should eql("new value2")
+    page.cookie?("addedCookieForPath1").should be_false
+
+    page.delete_cookie "addedCookieForPath2", "/selenium-server/org/openqa/selenium/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/org/openqa/selenium/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

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

@@ -0,0 +1,33 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Remote Control Logs Retrieval" do
+  # it "can retrieve logs even when the is no session was started" do
+  #   selenium_driver.stop
+  #   logs = selenium_driver.retrieve_last_remote_control_logs
+  #
+  #   logs.should =~ %r{request: retrieveLastRemoteControlLogs\[, \]}
+  #   logs.should =~ %r{Got result: OK}
+  # end
+  #
+  # it "can retrieve logs even when no command were issued" do
+  #   page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html"
+  #   logs = selenium_driver.retrieve_last_remote_control_logs
+  #
+  #   logs.should =~ %r{request: getNewBrowserSession\[\*[a-z0-9]+, http://localhost:4567, , \]}
+  #   logs.should =~ %r{request: open\[http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html, \]}
+  #   logs.should =~ %r{request: retrieveLastRemoteControlLogs\[, \]}
+  #   logs.should =~ %r{org.openqa.selenium.server.SeleniumDriverResourceHandler - Got result: OK}
+  # end
+  #
+  # it "can retrieve logs even when commands were issued" do
+  #   page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html"
+  #   page.get_title
+  #   logs = selenium_driver.retrieve_last_remote_control_logs
+  #
+  #   logs.should =~ %r{request: getNewBrowserSession\[\*[a-z0-9]+, http://localhost:4567, , \]}
+  #   logs.should =~ %r{request: open\[http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html, \]}
+  #   logs.should =~ %r{request: getTitle\[, \]}
+  #   logs.should =~ %r{request: retrieveLastRemoteControlLogs\[, \]}
+  #   logs.should =~ %r{org.openqa.selenium.server.SeleniumDriverResourceHandler - Got result: OK}
+  # end
+end

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

@@ -0,0 +1,31 @@
+# encoding: binary
+
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Screenshot" do
+  it "can capture html for current page" do
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html"
+    page.get_html_source.should =~ /<head>/
+  end
+
+  it "captures PNG screenshot OS viewport as a file on Selenium RC local filesystem" do
+    tempfile = File.join(Dir.tmpdir, "selenium_screenshot.png")
+
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html"
+    page.capture_screenshot tempfile
+
+    File.exists?(tempfile).should be_true
+    File.open(tempfile, "rb") do |io|
+      magic = io.read(4)
+      magic.should == "\211PNG"
+    end
+  end
+
+  it "captures PNG screenshot OS viewport as a Base64 encoded PNG image" do
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_click_page1.html"
+    encodedImage = page.capture_screenshot_to_string
+    pngImage = Base64.decode64(encodedImage)
+
+    pngImage.should =~ /^\211PNG/n
+  end
+end

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

@@ -0,0 +1,46 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Window Selection" do
+  it "selects and close popup windows" do
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_select_window.html"
+    page.click "popupPage", :wait_for => :popup, :window => "myPopupWindow", :select => true
+
+    page.location.should =~ %r{/tests/html/test_select_window_popup.html}
+    page.title.should =~ /Select Window Popup/
+    page.all_window_names.size.should eql(2)
+    page.all_window_names.include?("myPopupWindow").should be_true
+
+    page.close
+    page.select_window "null"
+
+    page.location.should =~ %r{/tests/html/test_select_window.html}
+
+    page.click "popupPage", :wait_for => :popup, :window => "myPopupWindow"
+    page.select_window "title=Select Window Popup"
+
+    page.location.should =~ %r{/tests/html/test_select_window_popup.html}
+
+    page.close
+    page.select_window "null"
+  end
+
+  it "select an anonymous window (one that isn't assigned to a variable)" do
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_select_window.html"
+    page.click "popupAnonymous", :wait_for => :popup, :window => "anonymouspopup", :select => true
+
+    page.location.should =~ %r{/tests/html/test_select_window_popup.html}
+
+    page.click "closePage"
+    page.select_window "null"
+  end
+
+  it "handles an onclick close handler" do
+    page.open "http://localhost:4444/selenium-server/org/openqa/selenium/tests/html/test_select_window.html"
+    page.click "popupAnonymous", :wait_for => :popup, :window => "anonymouspopup", :select => true
+
+    page.location.should =~ %r{/tests/html/test_select_window_popup.html}
+
+    page.click "closePage2"
+    page.select_window "null"
+  end
+end

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

@@ -0,0 +1,9 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+describe "Session Management" do
+  it "can call stop even when session was not started" do
+    in_separate_driver do
+      3.times { selenium_driver.close_current_browser_session }
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "Wait For Ajax" do
+  describe "Prototype" do
+    it "blocks until AJAX request is complete" do
+      page.open "http://localhost:4567/prototype.html"
+      page.text("calculator-result").should be_empty
+      page.type "calculator-expression", "2 + 2"
+      page.click "calculator-button", :wait_for => :ajax
+
+      page.value("calculator-result").should eql("4")
+    end
+  end
+
+  describe "jQuery" do
+    it "blocks until AJAX request is complete" do
+      page.open "http://localhost:4567/jquery.html"
+
+      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")
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "#wait_for_element" do
+  it "does not block when element is present" do
+    page.open "http://localhost:4567/jquery.html"
+    page.wait_for_element "element-present-demo"
+    page.wait_for_element "id=element-present-demo"
+    page.wait_for_element "css=#element-present-demo"
+  end
+
+  it "times out when element is not present" do
+    page.open "http://localhost:4567/jquery.html"
+
+    should_timeout do
+      page.wait_for_element "new-element", :timeout_in_seconds => 2
+    end
+
+    should_timeout do
+      page.wait_for_element "does-not-exists", :timeout_in_seconds => 2
+    end
+  end
+
+  it "detects dynamics changes in the DOM" do
+    page.open "http://localhost:4567/jquery.html"
+    page.click "create-element-button", :wait_for => :element, :element => 'new-element'
+    page.click "delete-element-button", :wait_for => :no_element, :element => 'new-element'
+
+    should_timeout do
+      page.wait_for_element "new-element", :timeout_in_seconds => 2
+    end
+  end
+
+  it "can handle quotes and double quotes in its locator definition" do
+    page.open "http://localhost:4567/jquery.html"
+    page.wait_for_element "//div[@id='element-present-demo']"
+    page.wait_for_no_element "//div[@id='new-element']"
+    page.click "create-element-button", :wait_for => :element, :element => "//div[@id='new-element']"
+  end
+end
+
+describe "#wait_for_no_element" do
+  it "does not block when element is not present" do
+    page.open "http://localhost:4567/jquery.html"
+    page.wait_for_no_element "new-element"
+    page.wait_for_no_element "does-not-exists"
+  end
+
+  it "times out when element is present" do
+    page.open "http://localhost:4567/jquery.html"
+
+    should_timeout do
+      page.wait_for_no_element "element-present-demo", :timeout_in_seconds => 2
+    end
+  end
+end
+

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

@@ -0,0 +1,52 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "#wait_for_field_value" do
+  it "blocks until field is updated" do
+    page.open "http://localhost:4567/jquery.html"
+
+    page.text("calculator-result").should be_empty
+
+    page.type "calculator-expression", "2 + 2"
+    page.click "calculator-button", :wait_for => :value,
+                                    :element  => "calculator-result",
+                                    :value    => "4"
+
+    page.value("calculator-result").should eql("4")
+  end
+
+
+  it "times out when field is never properly updated" do
+    page.open "http://localhost:4567/jquery.html"
+
+    page.text("calculator-result").should be_empty
+    page.type "calculator-expression", "2 + 2"
+
+    should_timeout do
+      page.click "calculator-button", :wait_for           => :value,
+                                      :element            => "calculator-result",
+                                      :value              => "5",
+                                      :timeout_in_seconds => 2
+    end
+  end
+end
+
+describe "#wait_for_no_field_value" do
+  it "blocks until field is updated" do
+    page.open "http://localhost:4567/jquery.html"
+
+    page.text("calculator-result").should be_empty
+    page.type "calculator-expression", "2 + 2"
+    page.click "calculator-button", :wait_for => :no_value,
+                                    :element  => "calculator-result",
+                                    :value    => ""
+
+    page.value("calculator-result").should eql("4")
+  end
+
+  it "times out when field is never properly updated" do
+    page.open "http://localhost:4567/jquery.html"
+    should_timeout do
+      page.wait_for_no_field_value "calculator-result", "", :timeout_in_seconds => 2
+    end
+  end
+end

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

@@ -0,0 +1,98 @@
+require File.expand_path(__FILE__ + '/../../spec_helper')
+
+describe "#wait_for_text" do
+  it "wait_for_text does not block when text is present" do
+    page.open "http://localhost:4567/jquery.html"
+    page.wait_for_text "jQuery - Selenium Ruby Client Sample App"
+    page.wait_for_text "jQuery - Selenium Ruby Client Sample App", :element => "title"
+  end
+
+  it "wait_for_text timeouts when text is not present" do
+    page.open "http://localhost:4567/jquery.html"
+
+    should_timeout do
+      page.wait_for_text "We All Need Some Mojo", :timeout_in_seconds => 2
+    end
+
+    should_timeout do
+      page.wait_for_text "We All Need Some Mojo",
+                         :element => "new-element", :timeout_in_seconds => 2
+    end
+  end
+
+  it "wait_for_text detects dynamics changes in the DOM" do
+    page.open "http://localhost:4567/jquery.html"
+    page.click "create-element-button", :wait_for => :text,
+                                        :text     => "We All Need Some Mojo"
+    page.click "delete-element-button", :wait_for => :no_text,
+                                        :text     => "We All Need Some Mojo"
+    page.click "create-element-button", :wait_for => :text,
+                                        :text     => "We All Need Some Mojo",
+                                        :element  => "new-element"
+    page.click "delete-element-button", :wait_for => :no_text,
+                                        :text     => "We All Need Some Mojo",
+                                        :element  => "new-element"
+    should_timeout do
+      page.wait_for_text "We All Need Some Mojo", :element => "new-element",
+                                                  :timeout_in_seconds => 2
+    end
+
+    should_timeout do
+      page.wait_for_text "We All Need Some Mojo", :timeout_in_seconds => 2
+    end
+  end
+
+  it "wait_for_text can handle quotes and double quotes in its locator definition" do
+    page.open "http://localhost:4567/jquery.html"
+
+    page.wait_for_text "jQuery - Selenium Ruby Client Sample App", :element => "//h1[@id='title']"
+    page.wait_for_no_text "Some With A ' Single Quote"
+
+    page.click "create-element-button", :wait_for => :text,
+                                        :text     => "We All Need Some Mojo",
+                                        :element  => "//div[@id='new-element']"
+  end
+
+  it "wait_for_text support incremental searches anywhere in the page" do
+    page.open "http://localhost:4567/jquery.html"
+
+    page.wait_for_text "Sample App"
+    page.wait_for_text "Ruby Client"
+  end
+
+  it "wait_for_text support matching text using regular expressions" do
+    page.open "http://localhost:4567/jquery.html"
+
+    page.wait_for_text(/Sample App/)
+    page.wait_for_text(/Sample.*App/)
+    page.wait_for_text(/Selenium.*Client/,      :element => "//h1[@id='title']")
+    page.wait_for_no_text(/^Selenium.*Client$/, :element => "//h1[@id='title']")
+    page.wait_for_text(/here/,                  :element => "dangerous-characters")
+    page.wait_for_text(/' \/ \\/,               :element => "dangerous-characters")
+  end
+end
+
+describe "#wait_for_no_text" do
+  it "does not block when element is not present" do
+    page.open "http://localhost:4567/jquery.html"
+    page.wait_for_no_text "Does Not Exists"
+    page.wait_for_no_text "We All Need Some Mojo"
+    page.wait_for_no_text "No The Actual Title", :element => "title"
+    page.wait_for_no_text "We All Need Some Mojo", :element => "new-element"
+    page.wait_for_no_text "We All Need Some Mojo", :element => "does-not-exists"
+  end
+
+  it "times out when element is present" do
+    page.open "http://localhost:4567/jquery.html"
+
+    should_timeout do
+      page.wait_for_no_text "jQuery - Selenium Ruby Client Sample App",
+                            :timeout_in_seconds => 2
+    end
+
+    should_timeout do
+      page.wait_for_no_text "jQuery - Selenium Ruby Client Sample App",
+                            :element => "title", :timeout_in_seconds => 2
+    end
+  end
+end