page-object 0.6 → 0.6.1

data/lib/page-object/elements/element.rb

@@ -38,6 +38,13 @@ module PageObject
       def enabled?
         @element.enabled?
       end
+
+      #
+      # return true if the element is not enabled
+      #
+      def disabled?
+        not enabled?
+      end
       
       #
       # get the value of the given CSS property
@@ -83,7 +90,7 @@ module PageObject
       def method_missing(*args, &block)
         m = args.shift
         puts "*** DEPRECATION WARNING"
-        puts "*** You are calling a method named #{m}."
+        puts "*** You are calling a method named #{m} at #{caller[0]}."
         puts "*** This method does not exist in page-object so it is being passed to the driver."
         puts "*** This feature will be removed in the near future."
         puts "*** Please change your code to call the correct page-object method."

data/lib/page-object/elements/text_field.rb

@@ -8,6 +8,10 @@ module PageObject
         include_platform_for platform
       end
 
+      def append(text)
+        @element.send_keys text
+      end
+
       protected
 
       def self.watir_finders

data/lib/page-object/platforms/selenium_webdriver/select_list.rb

@@ -25,15 +25,42 @@ module PageObject
         #
         # @return [array of PageObject::Elements::Option]
         def options
-          options = @element.find_elements(:xpath, child_xpath)
-          elements = []
-          options.each do |opt|
-            elements << Object::PageObject::Elements::Option.new(opt, :platform => :selenium_webdriver)
-          end
-          elements
+          find_options.map { |e| ::PageObject::Elements::Option.new(e, :platform => :selenium_webdriver) }
+        end
+
+        #
+        # @return [Array<String>] An array of strings representing the text value of the currently selected options.
+        #
+        def selected_options
+          find_options.map { |e| e.text if e.selected? }.compact
+        end
+
+        #
+        # Returns true if the select list has one or more options where text or label matches the given value.
+        #
+        # @param [String, Regexp] value A value.
+        # @return [Boolean]
+        def include?(value)
+          find_options.any? { |e| e.text == value }
+        end
+
+        #
+        # Returns true if any of the selected options' text match the given value.
+        #
+        # @param [String, Regexp] value A value.
+        # @return [Boolean]
+        def selected?(value)
+          selected = find_options.select { |e| e if e.selected? }
+          selected.any? { |e| e.text == value }
+        end
+
+        private
+
+        def find_options
+          @element.find_elements(:xpath, child_xpath)
         end
       end
     end
   end
 
-end
+end

data/lib/page-object/platforms/watir_webdriver/select_list.rb

@@ -33,8 +33,32 @@ module PageObject
           end
           elements
         end
+
+        #
+        # @return [Array<String>] An array of strings representing the text value of the currently selected options.
+        #
+        def selected_options
+          @element.selected_options
+        end
+
+        #
+        # Returns true if the select list has one or more options where text or label matches the given value.
+        #
+        # @param [String, Regexp] value A value.
+        # @return [Boolean]
+        def include?(value)
+          @element.include? value
+        end
+        
+        #
+        # Returns true if any of the selected options' text or label match the given value.
+        #
+        # @param [String, Regexp] value A value.
+        # @return [Boolean]
+        def selected?(value)
+          @element.selected? value
+        end
       end
     end
   end
-
-end
+end

data/lib/page-object/version.rb

@@ -1,4 +1,4 @@
 module PageObject
   # @private
-  VERSION = "0.6"
+  VERSION = "0.6.1"
 end

data/page-object.gemspec

@@ -20,7 +20,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_dependency 'watir-webdriver', '>= 0.4.1'
-  s.add_dependency 'selenium-webdriver', '>= 2.16.0' 
+  s.add_dependency 'selenium-webdriver', '>= 2.17.0' 
   
   s.add_development_dependency 'rspec', '>= 2.6.0'
   s.add_development_dependency 'cucumber', '>= 1.1.0'

data/spec/page-object/elements/element_spec.rb

@@ -2,7 +2,7 @@ require 'spec_helper'
 require 'page-object/elements'
 
 
-describe "Element class methods" do
+describe "Element" do
 
   context "when building the identifiers for Watir" do
     it "should build xpath when finding elements by name where not supported" do
@@ -75,5 +75,40 @@ describe "Element class methods" do
         what.should include ".//input[@type='#{type}' and @name='foo' and @class='bar']"
       end
     end
-  end  
+  end
+
+  context "interaction with native element" do
+    let(:native) { double('') }
+    let(:element) { PageObject::Elements::Element.new(native, :platform => :watir_webdriver) }
+
+    it "should check if native is enabled" do
+      native.should_receive(:enabled?).and_return(true)
+      element.should be_enabled
+    end
+
+    it "should click the native" do
+      native.should_receive(:click)
+      element.click
+    end
+
+    it "should double click the native" do
+      native.should_receive(:double_click)
+      element.double_click
+    end
+
+    it "should inspect the native" do
+      native.should_receive(:inspect)
+      element.inspect
+    end
+
+    it "should retrieve the native's style" do
+      native.should_receive(:style).with('foo').and_return("cheezy_style")
+      element.style('foo').should == 'cheezy_style'
+    end
+
+    it "should know if a native is disabled" do
+      native.should_receive(:enabled?).and_return(false)
+      element.should be_disabled
+    end
+  end
 end

data/spec/page-object/elements/select_list_spec.rb

@@ -27,6 +27,12 @@ describe PageObject::Elements::SelectList do
     before(:each) do
       sel_list.stub(:find_elements).and_return(sel_list)
       sel_list.stub(:each)
+      sel_list.stub(:wd).and_return(sel_list)
+      sel_list.stub(:map).and_return(opts)
+      sel_list.stub(:any?)
+      sel_list.stub(:include?)
+      sel_list.stub(:select).and_return(opts)
+      sel_list.stub(:text).and_return('blah')
     end
 
     it "should register with tag_name :select" do
@@ -34,39 +40,74 @@ describe PageObject::Elements::SelectList do
     end
 
     context "for watir" do
+      let(:watir_sel_list) { PageObject::Elements::SelectList.new(sel_list, :platform => :watir_webdriver) }
+
       it "should return an option when indexed" do
-        watir_sel_list = PageObject::Elements::SelectList.new(sel_list, :platform => :watir_webdriver)
-        sel_list.stub(:wd).and_return(sel_list)
         sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
         watir_sel_list[0].should be_instance_of PageObject::Elements::Option
       end
 
       it "should return an array of options" do
-        watir_sel_list = PageObject::Elements::SelectList.new(sel_list, :platform => :watir_webdriver)
-        sel_list.stub(:wd).and_return(sel_list)
         sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
         watir_sel_list.options.size.should == 2
       end
+
+      it "should return an array of selected options" do
+        sel_list.stub(:selected_options).and_return(opts)
+        watir_sel_list.selected_options.should == opts
+      end
+
+      it "should know if it includes some value" do
+        sel_list.stub(:include?).with('blah').and_return(true)
+        watir_sel_list.include?('blah')
+      end
+
+      it "should know if an option is selected" do
+        sel_list.stub(:selected?).with('blah').and_return(true)
+        watir_sel_list.selected?('blah')
+      end
     end
 
-    context "for selenium" do
+    context "for selenium"  do
+      let(:selenium_sel_list) { PageObject::Elements::SelectList.new(sel_list, :platform => :selenium_webdriver) }
+      
       it "should return an option when indexed" do
-        selenium_sel_list = PageObject::Elements::SelectList.new(sel_list, :platform => :selenium_webdriver)
         sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
         selenium_sel_list[1].should be_instance_of PageObject::Elements::Option
       end
 
       it "should return an array of options" do
-        selenium_sel_list = PageObject::Elements::SelectList.new(sel_list, :platform => :selenium_webdriver)
         sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
         selenium_sel_list.options.size.should == 2
       end
 
       it "should select an element" do
-        selenium_sel_list = PageObject::Elements::SelectList.new(sel_list, :platform => :selenium_webdriver)
         sel_list.should_receive(:send_keys).with('something')
         selenium_sel_list.select 'something'
       end
+      
+      it "should return an array of selected options" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        opts[0].should_receive(:selected?).and_return(true)
+        opts[0].should_receive(:text).and_return('test1')
+        opts[1].should_receive(:selected?).and_return(false)
+        selected = selenium_sel_list.selected_options
+        selected.size.should == 1
+        selected[0].should == 'test1'
+      end
+
+      it "should know if it includes some value" do
+        sel_list.should_receive(:find_elements).and_return(opts)
+        opts[0].should_receive(:text).and_return('blah')
+        selenium_sel_list.should include 'blah'
+      end
+      
+      it "should know if an option is selected" do
+        sel_list.should_receive(:find_elements).and_return(opts)
+        opts[0].should_receive(:selected?).twice.and_return(true)
+        opts[0].should_receive(:text).and_return('blah')
+        selenium_sel_list.selected?('blah').should be_true
+      end
     end
   end
 end

data/spec/page-object/elements/text_field_spec.rb

@@ -32,6 +32,9 @@ describe PageObject::Elements::TextField do
   end
   
   describe "interface" do
+    let(:text_field_element) { double('text_field') }
+    let(:selenium_text_field) { PageObject::Elements::TextField.new(text_field_element, :platform => :selenium_webdriver) }
+
     it "should register with type :text" do
       ::PageObject::Elements.element_class_for(:input, :text).should == ::PageObject::Elements::TextField
     end
@@ -39,11 +42,14 @@ describe PageObject::Elements::TextField do
     it "should register with type :password" do
       ::PageObject::Elements.element_class_for(:input, :password).should == ::PageObject::Elements::TextField
     end
+
+    it "should append text" do
+      text_field_element.should_receive(:send_keys).with('abc')
+      selenium_text_field.append('abc')
+    end
     
     context "for selenium" do
       it "should set its' value" do
-        text_field_element = double('selenium_text_field')
-        selenium_text_field = PageObject::Elements::TextField.new(text_field_element, :platform => :selenium_webdriver)
         text_field_element.should_receive(:clear)
         text_field_element.should_receive(:send_keys).with('Joseph')
         selenium_text_field.value = 'Joseph'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page-object
 version: !ruby/object:Gem::Version
-  version: '0.6'
+  version: 0.6.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-01-11 00:00:00.000000000 Z
+date: 2012-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &70258715882600 !ruby/object:Gem::Requirement
+  requirement: &70219783537560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,21 +21,21 @@ dependencies:
         version: 0.4.1
   type: :runtime
   prerelease: false
-  version_requirements: *70258715882600
+  version_requirements: *70219783537560
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
-  requirement: &70258711304260 !ruby/object:Gem::Requirement
+  requirement: &70219783530900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 2.16.0
+        version: 2.17.0
   type: :runtime
   prerelease: false
-  version_requirements: *70258711304260
+  version_requirements: *70219783530900
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70258711301120 !ruby/object:Gem::Requirement
+  requirement: &70219789108140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 2.6.0
   type: :development
   prerelease: false
-  version_requirements: *70258711301120
+  version_requirements: *70219789108140
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &70258711300560 !ruby/object:Gem::Requirement
+  requirement: &70219789106820 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 1.1.0
   type: :development
   prerelease: false
-  version_requirements: *70258711300560
+  version_requirements: *70219789106820
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70258711298760 !ruby/object:Gem::Requirement
+  requirement: &70219789105960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +65,7 @@ dependencies:
         version: 0.7.2
   type: :development
   prerelease: false
-  version_requirements: *70258711298760
+  version_requirements: *70219789105960
 description: Page Object DSL that works with both Watir and Selenium
 email:
 - jeff.morgan@leandog.com