Selenium 1.1.11 → 1.1.12

data/lib/selenium.rb

@@ -6,10 +6,13 @@ require 'selenium_server'
 require 'web_page'
 require 'server'
 
+require 'alert'
 require 'html_element'
 require 'button'
 require 'link'
 require 'locator'
 require 'text_field'
+require 'text_area'
+require 'key'
 
 

data/lib/selenium/alert.rb

@@ -0,0 +1,15 @@
+module Selenium
+  class Alert
+    def initialize(webpage)
+      @webpage = webpage
+    end
+
+    def present?
+      @webpage.alert_present?
+    end
+
+    def message
+      @webpage.alert_message
+    end
+  end
+end

data/lib/selenium/html_element.rb

@@ -11,8 +11,12 @@ module Selenium
       webpage.browser
     end
 
+    def text
+      @webpage.text(@locator)
+    end
+
     def present?
-      webpage.browser.is_element_present @locator
+      @webpage.element_present? @locator
     end
 
     # click the element
@@ -26,5 +30,13 @@ module Selenium
       @webpage.click_wait(@locator)
     end
 
+    def double_click
+      @webpage.double_click(@locator)
+    end
+
+    def key_press(key)
+      @webpage.key_press(@locator, key)
+    end
+
   end
 end

data/lib/selenium/key.rb

@@ -0,0 +1,16 @@
+module Selenium
+  class Key
+    def initialize(webpage, key)
+      @webpage = webpage
+      @key = key
+    end
+
+    def up
+      @webpage.key_up(@key)
+    end
+
+    def down
+      @webpage.key_down(@key)
+    end
+  end
+end

data/lib/selenium/selenium_server.rb

@@ -34,13 +34,15 @@ module Selenium
 
     public
     attr_reader :port_number, :request_timeout
+    # Turn off INFO level server logs, only WARN and above message will be printed
     attr_accessor :print_log
 
     # Initialize the server driver with an opitonal port number (default to 4444)
-    def initialize(port_number_to_use = 4444)
+    # and request timeout (default to 30)
+    def initialize(port_number_to_use = 4444, request_timeout=30)
       port_number_to_use = 4444 unless port_number_to_use
       @port_number = port_number_to_use
-      @request_timeout = 30
+      @request_timeout = request_timeout
       @print_log = false
     end
 

data/lib/selenium/server.rb

@@ -21,12 +21,21 @@ class Server
   # * error
   attr_reader :status
 
+  # The timeout setting for selenium in seconds
+  attr_reader :timeout
+
   def Server::on_port(port)
     Server.new(SeleniumServer.new(port))
   end
 
-  def initialize(server = SeleniumServer.new)
-    @server = server
+  # Create a selenium server that can be controlled directly
+  def initialize(port_number, timeout=60)
+    if port_number.is_a? SeleniumServer
+      # backward compatibility, to be removed in 2.0
+      @server = port_number 
+    else
+      @server = SeleniumServer.new(port_number, timeout)
+    end
     @status = 'stopped'
   end
 

data/lib/selenium/text_area.rb

@@ -0,0 +1,15 @@
+module Selenium
+class TextArea < HtmlElement
+  def initialize(webpage, locator)
+    super(webpage, locator)
+  end
+
+  def enter(value)
+    @webpage.enter(@locator, value)
+  end
+
+  def value
+    @webpage.value(@locator)
+  end
+end
+end

data/lib/selenium/text_field.rb

@@ -1,6 +1,5 @@
 module Selenium
 class TextField < HtmlElement
-  attr_reader :browser
   
   def initialize(webpage, locator)
     super(webpage, locator)

data/lib/selenium/version

@@ -1 +1 @@
-1.1.11
+1.1.12

data/lib/selenium/web_page.rb

@@ -3,6 +3,13 @@ $:.unshift File.dirname(__FILE__)
 require 'timeout'
 
 module Selenium
+  # Error that is thrown when a key is not supported
+  class NoKeyError < NameError
+    def initialize(key)
+      super(key)
+    end
+  end
+
   # Class that models a web page with a title
   class WebPage
     attr_reader :browser
@@ -32,6 +39,14 @@ module Selenium
       @browser.get_html_source
     end
 
+    def speed=(value)
+      @browser.set_speed(value)
+    end
+
+    def speed
+      @browser.get_speed.to_i
+    end
+
     def wait_for_load
       @browser.wait_for_page_to_load
     end
@@ -44,6 +59,10 @@ module Selenium
       end
     end
 
+    def alert
+      Alert.new(self)
+    end
+
     def link(how, what=nil)
       if (how == :text)
         locator = "link=#{what}"
@@ -59,8 +78,12 @@ module Selenium
       TextField.new(self, element_locator(how, what))
     end
 
-    def button(how, what=nil)
-      Button.new(self, element_locator(how, what))
+    def text_area(how, what=nil)
+      TextArea.new(self, element_locator(how, what))
+    end
+
+    def element(how, what=nil)
+      HtmlElement.new(self, element_locator(how,what))
     end
 
     def element_locator(how, what=nil)
@@ -78,8 +101,9 @@ module Selenium
       FileUpload.new(self, element_locator(how, what))
     end
 
-    def open(url)
+    def open_page(url)
       @browser.open(url)
+      wait_for_load
     end
 
     def close
@@ -90,6 +114,34 @@ module Selenium
       @browser.click(locator)
     end
 
+    def text(locator)
+      @browser.get_text(locator)
+    end
+
+    def button(how, what=nil)
+      Button.new(self, element_locator(how, what))
+    end
+
+    def key(key)
+      Key.new(self, key)
+    end
+
+    def element_present?(locator)
+      @browser.is_element_present(locator)
+    end
+
+    def alert_present?
+      @browser.is_alert_present
+    end
+
+    def text_present?(text)
+      @browser.is_text_present(text)
+    end
+
+    def double_click(locator)
+      @browser.double_click(locator)
+    end
+
     def click_wait(locator)
       click(locator)
       wait_for_load
@@ -104,6 +156,38 @@ module Selenium
       @browser.get_value(locator)
     end
 
+    def alert_message
+      @browser.get_alert
+    end
+
+    def context_menu(locator)
+      @browser.context_menu(locator)
+    end
+
+    def fire_event(locator, event)
+      @browser.fire_event(locator, event)
+    end
+
+    def key_down(key)
+      message = "#{key}_key_down"
+      raise NoKeyError.new(key.to_s) unless @browser.respond_to? message
+      @browser.send message
+    end
+
+    def key_up(key)
+      message = "#{key}_key_up"
+      raise NoKeyError.new(key.to_s) unless @browser.respond_to? message
+      @browser.send message
+    end
+
+    def key_press(locator, key)
+      @browser.key_press(locator, key)
+    end
+
+    def focus(locator)
+      @browser.focus(locator)
+    end
+
     def upload(locator, file)
 #      @browser.attach_file(locator, file)
       @browser.click(locator)
@@ -120,6 +204,10 @@ module Selenium
     def capture_screen(file)
       @browser.capture_screenshot(file)
     end
+
+    def to_s
+      "#{self.class}('#{@expected_title}') - #{browser.to_s}"
+    end
 	
   end
 end

data/spec/selenium/examples/selenium_ruby.rb

@@ -0,0 +1,9 @@
+$:.unshift File.dirname(__FILE__)
+
+require '../../../lib/selenium'
+require 'selenium_ruby/selenium_ruby_page'
+require 'selenium_ruby/home_page'
+require 'selenium_ruby/directory_listing_page'
+require 'selenium_ruby/download_page'
+require 'selenium_ruby/license_page'
+require 'selenium_ruby/menu'

data/spec/selenium/selenium.rb

@@ -0,0 +1,8 @@
+$:.unshift File.join(File.dirname(__FILE__), '..', '..')
+
+require 'spec'
+require 'lib/selenium'
+
+module Selenium
+  BROWSER = '*chrome D:\Program Files\Mozilla Firefox2\firefox.exe'
+end

data/spec/selenium/tc_html_element.rb

@@ -0,0 +1,32 @@
+$:.unshift(File.dirname(__FILE__))
+
+require 'selenium'
+
+module Selenium
+  describe HtmlElement do
+    before(:all) do
+      @server = Server.new(4445)
+      @server.start
+      @webpage = @server.open(BROWSER, 'http://localhost:2000/test/index.html')
+    end
+
+    before do
+      @webpage.open_page('/test/index.html')
+    end
+
+    after(:all) do
+      @webpage.close if @webpage
+      @server.stop
+    end
+
+    it 'should support double click and key press' do
+      text_area = @webpage.text_area(:name, 'doubleclick')
+      text_area.enter 'html double click'
+      text_area.double_click
+      @webpage.alert.should be_present
+      @webpage.alert.message.should == 'double clicked with value html double click'
+      text_area.key_press('b')
+      text_area.value.should == 'html double clickb'
+    end
+  end
+end

data/spec/selenium/tc_interaction_example.rb

@@ -18,7 +18,7 @@ context 'Test goole search' do
   end
 
   specify'searh hello world with google using interaction based script' do
-    @page.open("/")
+    @page.open_page("/")
     @page.title.should == 'Google'
     @page.enter("q", "hello world")
     @page.click("btnG")

data/spec/selenium/tc_web_page.rb

@@ -6,6 +6,30 @@ require 'lib/selenium'
 
 module Selenium
   describe WebPage do
+    before(:all) do
+      @server = Server.new(2344)
+      @server.start
+      @@webpage = nil
+    end
+
+    before do
+      @@webpage.open_page('/') if @@webpage
+    end
+
+    after(:all) do
+      @server.stop
+    end
+
+    def webpage
+      @@webpage = @server.open('*chrome D:\Program Files\Mozilla Firefox2\firefox.exe', 'http://localhost:2000/') unless @@webpage
+      @@webpage
+    end
+
+    it 'should have meaningful to_s support' do
+      webpage = WebPage.new(SeleniumDriver.new('localhost', 2222, '*chrome', 'http://www.example.com', 60000), 'expected title')
+      webpage.to_s.should == 'Selenium::WebPage(\'expected title\') - SeleniumDriver'
+    end
+
     it 'should create link based on text' do
       webpage = WebPage.new('browser')
       webpage.link(:text, 'text').locator.should == 'link=text'
@@ -15,5 +39,55 @@ module Selenium
       webpage = WebPage.new('browser')
       webpage.link(:href, 'a.html').locator.should == "xpath=//a[@href='a.html']"
     end
+
+    it 'should support double click and key press' do
+      webpage.open_page('/test/index.html')
+      webpage.enter('doubleclick', 'webpage')
+      webpage.double_click('doubleclick')
+      webpage.should be_alert_present
+      webpage.alert_message.should == 'double clicked with value webpage'
+      webpage.key_press('doubleclick', 'a')
+      webpage.value('doubleclick').should == 'webpagea'
+    end
+
+    it 'should support context menu' do
+      webpage.open_page('/test/index.html')
+      webpage.context_menu('link=License')
+      webpage.capture_screen(File.join(File.dirname(__FILE__), 'screenshot.png'))
+    end
+
+    it 'should support focus event and fire blur event' do
+      webpage.open_page('/test/index.html')
+      webpage.focus('events')
+      webpage.enter('events', 'value')
+      webpage.value('events').should == 'value'
+      webpage.fire_event('events', 'blur')
+      webpage.should be_alert_present
+      webpage.alert_message.should == 'blurred with value value'
+      webpage.fire_event('events', 'focus')
+#      webpage.focus('events')
+      webpage.value('events').should == 'default'
+    end
+
+    it 'should support key event and check if it is supported' do
+      webpage.open_page('/test/index.httml')
+      webpage.key_down(:shift)
+      webpage.key_up(:shift)
+      [:shift, :meta, :alt, :control].each do |key|
+        key = webpage.key(key)
+        key.down
+        key.up
+      end
+      webpage.key(:alt).down
+
+      Proc.new {webpage.key_up(:command)}.should raise_error(NoKeyError)
+      Proc.new {webpage.key_down(:command)}.should raise_error(NoKeyError)
+    end
+
+    it 'should have speed as attribute' do
+      webpage.speed = 500
+      webpage.speed.should == 500
+    end
+
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: Selenium
 version: !ruby/object:Gem::Version 
-  version: 1.1.11
+  version: 1.1.12
 platform: ruby
 authors: 
 - Shane Duan
@@ -9,7 +9,7 @@ autorequire: selenium
 bindir: bin
 cert_chain: []
 
-date: 2008-07-12 00:00:00 -07:00
+date: 2008-07-13 00:00:00 -07:00
 default_executable: selenium
 dependencies: []
 
@@ -24,6 +24,7 @@ extra_rdoc_files:
 files: 
 - bin/selenium
 - lib/selenium
+- lib/selenium/alert.rb
 - lib/selenium/autoit
 - lib/selenium/autoit/AutoItX3.dll
 - lib/selenium/autoit/README
@@ -33,6 +34,7 @@ files:
 - lib/selenium/button.rb
 - lib/selenium/file_upload.rb
 - lib/selenium/html_element.rb
+- lib/selenium/key.rb
 - lib/selenium/link.rb
 - lib/selenium/locator.rb
 - lib/selenium/openqa
@@ -44,6 +46,7 @@ files:
 - lib/selenium/selenium_server.rb
 - lib/selenium/server.rb
 - lib/selenium/server_manager.rb
+- lib/selenium/text_area.rb
 - lib/selenium/text_field.rb
 - lib/selenium/version
 - lib/selenium/web_page.rb
@@ -57,12 +60,16 @@ files:
 - spec/selenium/examples/selenium_ruby/license_page.rb
 - spec/selenium/examples/selenium_ruby/menu.rb
 - spec/selenium/examples/selenium_ruby/selenium_ruby_page.rb
+- spec/selenium/examples/selenium_ruby.rb
 - spec/selenium/manual_tc_file_upload.rb
 - spec/selenium/manual_tc_timout.rb
+- spec/selenium/screenshot.png
+- spec/selenium/selenium.rb
 - spec/selenium/tc_auto_it.rb
 - spec/selenium/tc_auto_it_window.rb
 - spec/selenium/tc_basic_operation.rb
 - spec/selenium/tc_domain_example.rb
+- spec/selenium/tc_html_element.rb
 - spec/selenium/tc_interaction_example.rb
 - spec/selenium/tc_server.rb
 - spec/selenium/tc_web_page.rb