@@ -1,17 +1,54 @@ Selenium-Client gem ChangeLog ============================= -1.2.11 -====== +1.2.11 (2008-02-27) +=================== + + - More idiomatic hash-based constructor for the client driver: + + Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :timeout_in_seconds => 10, + :url => "http://localhost:3000" + + - Added jQuery support for wait_for_ajax + + - Can set default javascript framework semantics when creating the + client driver: + + Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :timeout_in_seconds => 10, + :url => "http://localhost:3000", + :javascript_framework => :jquery + + - Can override default javascript framework semantics on a specific + API call: + + driver.click "a-button" , :wait_for => :ajax, :javascript_framework => :jquery + + - Added new wait_for semantic: `:value` and `:no_value`: + + click :wait_for => :value, :element => 'a_locator', :value => 'some value' # will wait for the field value of 'a_locator' to be 'some value' + click :wait_for => :no_value, :element => 'a_locator', :value => 'some value' # will wait for the field value of 'a_locator' to not be 'some value' - Include examples in RubyGem - Added visible? method - Wait for complete shutdown when stopping Selenium RC with "rake selenium:rc:stop" (Thanks Aaron Tinio for the patch) - - Fixed the integration build on Windows - -1.2.10 -======= + - Fixed integration build on Windows + - Support locator including single quotes in wait_for_xyz methods + (Thanks Aaron Tinio for the patch) + - Fixed various bugs in wait_for_xyz methods + - API tests now rely on a demo application for integration testing of + wait_for_xyz methods + +1.2.10 (2008-02-02) +=================== - Upgraded RSpec support to 1.1.12 ChangeLog @@ -78,11 +78,17 @@ Plain API # Sample Ruby script using the Selenium client API # require "rubygems" - gem "selenium-client", ">=1.2.10" + gem "selenium-client", ">=1.2.11" require "selenium/client" begin - @browser = Selenium::Client::Driver.new("localhost", 4444, "*firefox", "http://www.google.com", 10000); + @browser = Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :url => "http://www.google.com", + :timeout_in_second => 60 + @browser.start_new_browser_session @browser.open "/" @browser.type "q", "Selenium seleniumhq.org" @@ -91,6 +97,7 @@ Plain API ensure @browser.close_current_browser_session end + Writing Tests ============= @@ -104,14 +111,20 @@ Writing Tests # require "test/unit" require "rubygems" - gem "selenium-client", ">=1.2.10" + gem "selenium-client", ">=1.2.11" require "selenium/client" class ExampleTest < Test::Unit::TestCase attr_reader :browser def setup - @browser = Selenium::Client::Driver.new "localhost", 4444, "*firefox", "http://www.google.com", 10000 + @browser = Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :url => "http://www.google.com", + :timeout_in_second => 60 + browser.start_new_browser_session end @@ -136,7 +149,7 @@ Writing Tests require 'rubygems' gem "rspec", "=1.1.12" - gem "selenium-client", ">=1.2.10" + gem "selenium-client", ">=1.2.11" require "selenium/client" require "selenium/rspec/spec_helper" @@ -145,7 +158,12 @@ Writing Tests alias :page :selenium_driver before(:all) do - @selenium_driver = Selenium::Client::Driver.new "localhost", 4444, "*firefox", "http://www.google.com", 10000 + @selenium_driver = Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :url => "http://www.google.com", + :timeout_in_second => 60 end before(:each) do README.markdown @@ -1,6 +1,6 @@ require 'rubygems' gem "rspec", "=1.1.12" -gem "selenium-client", ">=1.2.10" +gem "selenium-client", ">=1.2.11" require "selenium/client" require "selenium/rspec/spec_helper" @@ -9,7 +9,12 @@ describe "Google Search" do alias :page :selenium_driver before(:all) do - @selenium_driver = Selenium::Client::Driver.new "localhost", 4444, "*firefox", "http://www.google.com", 10000 + @selenium_driver = Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :url => "http://www.google.com", + :timeout_in_second => 60 end before(:each) do examples/rspec/google_spec.rb @@ -3,11 +3,17 @@ # Sample Ruby script using the Selenium client API # require "rubygems" -gem "selenium-client", ">=1.2.10" +gem "selenium-client", ">=1.2.11" require "selenium/client" begin - @browser = Selenium::Client::Driver.new("localhost", 4444, "*firefox", "http://www.google.com", 10000); + @browser = Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :url => "http://www.google.com", + :timeout_in_second => 60 + @browser.start_new_browser_session @browser.open "/" @browser.type "q", "Selenium seleniumhq.org" examples/script/google.rb @@ -4,14 +4,20 @@ # require "test/unit" require "rubygems" -gem "selenium-client", ">=1.2.10" +gem "selenium-client", ">=1.2.11" require "selenium/client" class ExampleTest < Test::Unit::TestCase attr_reader :browser def setup - @browser = Selenium::Client::Driver.new "localhost", 4444, "*firefox", "http://www.google.com", 10000 + @browser = Selenium::Client::Driver.new \ + :host => "localhost", + :port => 4444, + :browser => "*firefox", + :url => "http://www.google.com", + :timeout_in_second => 60 + browser.start_new_browser_session end examples/testunit/google_test.rb @@ -2,8 +2,6 @@ module Selenium module Client # Driver constructor and session management commands - # - # Original code by Aslak Hellesoy and Darren Hobbs module Base include Selenium::Client::Protocol include Selenium::Client::GeneratedDriver @@ -13,6 +11,29 @@ module Selenium attr_reader :host, :port, :browser_string, :browser_url, :default_timeout_in_seconds, :default_javascript_framework + # + # Create a new client driver + # + # Example: + # + # Selenium::Client::Driver.new \ + # :host => "localhost", + # :port => 4444, + # :browser => "*firefox", + # :timeout_in_seconds => 10, + # :url => "http://localhost:3000", + # + # You can also set the default javascript framework used for :wait_for + # AJAX and effects semantics (:prototype is the default value): + # + # Selenium::Client::Driver.new \ + # :host => "localhost", + # :port => 4444, + # :browser => "*firefox", + # :timeout_in_seconds => 10, + # :url => "http://localhost:3000", + # :javascript_framework => :jquery + # def initialize(*args) if args[0].kind_of?(Hash) options = args[0] lib/selenium/client/base.rb @@ -4,6 +4,7 @@ module Selenium # Client driver providing the complete API to drive a Selenium Remote Control class Driver include Selenium::Client::Base + end end lib/selenium/client/driver.rb @@ -127,9 +127,9 @@ module Selenium # * click :wait_for => :text, :element => 'a_locator', :text => 'some text' # will wait for the content of 'a_locator' to be 'some text' # * click :wait_for => :no_text, :text => 'some text' # will wait for the text to be not be present/disappear # * click :wait_for => :no_text, :element => 'a_locator', :text => 'some text' # will wait for the content of 'a_locator' to not be 'some text' - # * click :wait_for => :condition, :javascript => 'some expression' # will wait for the javascript expression to be true # * click :wait_for => :value, :element => 'a_locator', :value => 'some value' # will wait for the field value of 'a_locator' to be 'some value' # * click :wait_for => :no_value, :element => 'a_locator', :value => 'some value' # will wait for the field value of 'a_locator' to not be 'some value' + # * click :wait_for => :condition, :javascript => 'some expression' # will wait for the javascript expression to be true # # Using options you can also define an explicit timeout (:timeout_in_seconds key). Otherwise the default driver timeout # is used. lib/selenium/client/idiomatic.rb @@ -29,7 +29,7 @@ Spec::Runner.configure do |config| def create_selenium_driver application_host = ENV['SELENIUM_APPLICATION_HOST'] || "localhost" application_port = ENV['SELENIUM_APPLICATION_PORT'] || "4567" - @selenium_driver = Selenium::SeleniumDriver.new \ + @selenium_driver = Selenium::Client::Driver.new \ :host => (ENV['SELENIUM_RC_HOST'] || "localhost"), :port => (ENV['SELENIUM_RC_PORT'] || 4444), :browser => (ENV['SELENIUM_BROWSER'] || "*firefox"), test/integration/spec_helper.rb 85c7aaaac20699322823336d57cdbfcc5c01aff1 Philippe Hanrigou philippe.hanrigou@gmail.com http://github.com/ph7/selenium-client/commit/8b146f32a93dbda086fed529030f26c380e0125f 8b146f32a93dbda086fed529030f26c380e0125f 2009-02-27T21:23:08-08:00 2009-02-27T21:23:08-08:00 Cleaning up the documentation before release da4406c839c4830a3f4cdf9b490e6d9fcbf69ddb Philippe Hanrigou philippe.hanrigou@gmail.com