rwebunit 1.0.3 → 1.3.0

data/lib/rwebunit/assert.rb

@@ -1,170 +1,214 @@
-require 'runit/assert'
+require 'test/unit/assertions'
 
 module RWebUnit
   module Assert
 
-    include RUNIT::Assert
+    include Test::Unit::Assertions
+    
+    def assert_not(condition, msg = "")
+      assert(!condition, msg)
+    end
+    
+    def assert_nil(actual, msg="")
+      assert(actual.nil?, msg)
+    end
 
-    #TODO for drag-n-drop, check the postion in list
-    #    def assert_position_in_list(list_element_id)
-    #      raise "not implemented"
-    #    end
+    def assert_not_nil(actual, msg="")
+      assert(!actual.nil?, msg)
+    end
 
-    ##
-    # text
+    def fail(message)
+      assert(false, message)
+    end
+
+    # assertions
+    def assert_title_equals(title)
+      assert_equals(title, @web_browser.page_title)
+    end
+    alias assert_title assert_title_equals
+
+    # Assert text present in page source (html)
+    #   assert_text_present("<h1>iTest2</h1>")
     def assert_text_present(text)
       assert((@web_browser.page_source.include? text), 'expected text: ' + text + ' not found')
     end
 
+    # Assert text not present in page source (html)
+    #   assert_text_not_present("<h1>iTest2</h1>")
     def assert_text_not_present(text)
       assert(!(@web_browser.page_source.include? text), 'expected text: ' + text + ' found')
     end
 
-    def assert_text_in_table(tableId, text)
-      elem = element_by_id(tableId)
-      assert_not_nil(elem, "tableId #{tableId} not exists")
-      assert_equal(elem.tagName.upcase, "TABLE")
-      puts elem.innerHTML if $DEBUG
-      assert(elem.innerHTML.include?(text), "the text #{text} not found in table #{tableId}")
-    end
 
-    def assert_text_not_in_table(tableId, text)
-      elem = element_by_id(tableId)
-      assert_equal(elem.tagName.upcase, "TABLE")
-      assert_not_nil(elem, "tableId #{tableId} not exists")            
-      assert(!elem.innerHTML.include?(text), "unexpected text #{text} found in table #{tableId}")
+    ##
+    # Link
+
+    # Assert a link with specified text (exact match) in the page
+    #
+    #  <a href="">Click Me</a>
+    #  assert_link_present_with_exact("Click Me") => true
+    #  assert_link_present_with_exact("Click") => false
+    #
+    def assert_link_present_with_exact(link_text)
+      @web_browser.links.each { |link|
+        return if link_text == link.text
+      }
+      fail( "can't find the link with text: #{link_text}")
     end
 
-    def assert_element_present(elementID)
-      assert_not_nil(element_by_id(elementID), "element with id #{elementID} not found")
+    def assert_link_not_present_with_exact(link_text)
+      @web_browser.links.each { |link|
+        assert(link_text != link.text, "unexpected link (exact): #{link_text} found")
+      }
     end
 
-    def assert_element_not_present(elementID)
-      assert_nil(element_by_id(elementID), "unexpected element with id #{elementID} found")
+    # Assert a link containing specified text in the page
+    #  
+    #  <a href="">Click Me</a>
+    #  assert_link_present_with_text("Click ") # => 
+    #
+    def assert_link_present_with_text(link_text)
+      @web_browser.links.each { |link|
+        return if link.text.include?(link_text)
+      }
+      fail( "can't find the link containing text: #{link_text}")
     end
 
-    def assert_text_in_element(elementID, text)
-      elem = element_by_id(elementID)
-      assert_not_nil(elem.innerText, "element #{elementID} has no text")
-      assert(elem.innerText.include?(text), "the text #{text} not found in element #{elementID}")
+    def assert_link_not_present_with_text(link_text)
+      @web_browser.links.each { |link|
+        assert(!link.text.include?(link_text), "unexpected link containing: #{link_text} found")
+      }
     end
 
+
     ##
     # Checkbox
-    def assert_checkbox_not_selected(checkBoxName)
+    def assert_checkbox_not_selected(checkbox_name)
       @web_browser.checkboxes.each { |checkbox|
-        if (checkbox.name == checkBoxName) then
-          assert(!checkbox.isSet?, "Checkbox #{checkBoxName} checked unexpected")
+        if (checkbox.name == checkbox_name) then
+          assert(!checkbox.isSet?, "Checkbox #{checkbox_name} is checked unexpectly")
         end
       }
     end
+	alias assert_checkbox_not_checked assert_checkbox_not_selected
 
-    def assert_checkbox_selected(checkBoxName)
+    def assert_checkbox_selected(checkbox_name)
       @web_browser.checkboxes.each { |checkbox|
-        if (checkbox.name == checkBoxName) then
-          assert(checkbox.isSet?, "Checkbox #{checkBoxName} not checked")
+        if (checkbox.name == checkbox_name) then
+          assert(checkbox.isSet?, "Checkbox #{checkbox_name} not checked")
         end
       }
     end
+	alias assert_checkbox_checked assert_checkbox_selected
 
     ##
     # select
-    def assert_option_value_not_present(selectName, optionValue)
+    def assert_option_value_not_present(select_name, option_value)
       @web_browser.select_lists.each { |select|
-        continue unless select.name == selectName
+        continue unless select.name == select_name
         select.o.each do |option| # items in the list
-          assert(!(option.value == optionValue), "unexpected select option: #{optionValue} for #{selectName} found")
+          assert(!(option.value == option_value), "unexpected select option: #{option_value} for #{select_name} found")
         end
       }
     end
+    alias assert_select_value_not_present assert_option_value_not_present
 
-    def assert_option_not_present(selectName, optionLabel)
+    def assert_option_not_present(select_name, option_label)
       @web_browser.select_lists.each { |select|
-        next unless select.name == selectName
+        next unless select.name == select_name
         select.o.each do |option| # items in the list
-          assert(!(option.text == optionLabel), "unexpected select option: #{optionLabel} for #{selectName} found")
+          assert(!(option.text == option_label), "unexpected select option: #{option_label} for #{select_name} found")
         end
       }
     end
+    alias assert_select_label_not_present assert_option_not_present
 
-    def assert_option_value_present(selectName, optionValue)
+    def assert_option_value_present(select_name, option_value)
       @web_browser.select_lists.each { |select|
-        next unless select.name == selectName
+        next unless select.name == select_name
         select.o.each do |option| # items in the list
-          return if option.value == optionValue
+          return if option.value == option_value
         end
       }
-      assert(false, "can't find the combob box with value: #{optionValue}")
+      assert(false, "can't find the combob box with value: #{option_value}")
     end
+    alias assert_select_value_present assert_option_value_present
 
-    def assert_option_present(selectName, optionLabel)
+    def assert_option_present(select_name, option_label)
       @web_browser.select_lists.each { |select|
-        next unless select.name == selectName
+        next unless select.name == select_name
         select.o.each do |option| # items in the list
-          return if option.text == optionLabel
+          return if option.text == option_label
         end
       }
-      assert(false, "can't find the combob box: #{selectName} with value: #{optionLabel}")
+      assert(false, "can't find the combob box: #{select_name} with value: #{option_label}")
     end
+    alias assert_select_label_present assert_option_present
 
-    def assert_option_equals(selectName, optionLabel)
+    def assert_option_equals(select_name, option_label)
       @web_browser.select_lists.each { |select|
-        next unless select.name == selectName
+        next unless select.name == select_name
         select.o.each do |option| # items in the list
-          if (option.text == optionLabel) then
-            assert_equal(select.value, option.value, "Select #{selectName}'s value is not equal to expected option label: '#{optionLabel}'")
+          if (option.text == option_label) then
+            assert_equal(select.value, option.value, "Select #{select_name}'s value is not equal to expected option label: '#{option_label}'")
           end
         end
       }
     end
+    alias assert_select_label assert_option_equals
 
-    def assert_option_value_equals(selectName, optionValue)
+    def assert_option_value_equals(select_name, option_value)
       @web_browser.select_lists.each { |select|
-        next unless select.name == selectName
-        assert_equal(select.value, optionValue, "Select #{selectName}'s value is not equal to expected: '#{optionValue}'")
+        next unless select.name == select_name
+        assert_equal(select.value, option_value, "Select #{select_name}'s value is not equal to expected: '#{option_value}'")
       }
     end
-
+    alias assert_select_value assert_option_value_equals
+    
     ##
     # radio
 
-    # radioGroup is the name field, radio options 'value' field
-    def assert_radio_option_not_present(radioGroup, radioOption)
+    # radio_group is the name field, radio options 'value' field
+    def assert_radio_option_not_present(radio_group, radio_option)
       @web_browser.radios.each { |radio|
-        if (radio.name == radioGroup) then
-          assert(!(radioOption == radio.value), "unexpected radio option: " + radioOption  + " found")
+        if (radio.name == radio_group) then
+          assert(!(radio_option == radio.value), "unexpected radio option: " + radio_option  + " found")
         end
       }
     end
-
-    def assert_radio_option_present(radioGroup, radioOption)
+	
+    def assert_radio_option_present(radio_group, radio_option)
       @web_browser.radios.each { |radio|
-        return if (radio.name == radioGroup) and (radioOption == radio.value)
+        return if (radio.name == radio_group) and (radio_option == radio.value)
       }
-      fail("can't find the radio option : '#{radioOption}'")
+      fail("can't find the radio option : '#{radio_option}'")
     end
 
-    def assert_radio_option_selected(radioGroup, radioOption)
+    def assert_radio_option_selected(radio_group, radio_option)
       @web_browser.radios.each { |radio|
-        if (radio.name == radioGroup and radioOption == radio.value) then
-          assert(radio.isSet?, "Radio button #{radioGroup}-[#{radioOption}] not checked")
+        if (radio.name == radio_group and radio_option == radio.value) then
+          assert(radio.isSet?, "Radio button #{radio_group}-[#{radio_option}] not checked")
         end
       }
     end
-
-    def assert_radio_option_not_selected(radioGroup, radioOption)
+	alias assert_radio_button_checked assert_radio_option_selected
+	alias assert_radio_option_checked assert_radio_option_selected
+	
+    def assert_radio_option_not_selected(radio_group, radio_option)
       @web_browser.radios.each { |radio|
-        if (radio.name == radioGroup and radioOption == radio.value) then
-          assert(!radio.isSet?, "Radio button #{radioGroup}-[#{radioOption}] checked unexpected")
+        if (radio.name == radio_group and radio_option == radio.value) then
+          assert(!radio.isSet?, "Radio button #{radio_group}-[#{radio_option}] checked unexpected")
         end
       }
     end
-
+    alias assert_radio_button_not_checked assert_radio_option_not_selected
+    alias assert_radio_option_not_checked assert_radio_option_not_selected
+	
     ##
     # Button
-    def assert_button_not_present(buttonId)
+    def assert_button_not_present(button_id)
       @web_browser.buttons.each { |button|
-        assert(button.id != buttonId, "unexpected button id: #{buttonId} found")
+        assert(button.id != button_id, "unexpected button id: #{button_id} found")
       }
     end
 
@@ -174,77 +218,144 @@ module RWebUnit
       }
     end
 
-    def assert_button_present(buttonID)
+    def assert_button_present(button_id)
       @web_browser.buttons.each { |button|
-        return if buttonID == button.id
+        return if button_id == button.id
       }
-      assert(false, "can't find the button with id: #{buttonID}")
+      assert(false, "can't find the button with id: #{button_id}")
     end
 
-    def assert_button_present_with_text(buttonText)
+    def assert_button_present_with_text(button_text)
       @web_browser.buttons.each { |button|
-        return if buttonText == button.value
+        return if button_text == button.value
       }
-      assert(false, "can't find the button with text: #{buttonText}")
+      assert(false, "can't find the button with text: #{button_text}")
     end
 
-    ##
-    # Link
-    def assert_link_present_with_exact(linkText)
-      @web_browser.links.each { |link|
-        return if linkText == link.text
-      }
-      fail( "can't find the link with text: #{linkText}")
-    end
-
-    def assert_link_not_present_with_exact(linkText)
-      @web_browser.links.each { |link|
-        assert(linkText != link.text, "unexpected link (exact): #{linkText} found")
-      }
-    end
-
-    def assert_link_present_with_text(linkText)
-      @web_browser.links.each { |link|
-        return if link.text.include?(linkText)
-      }
-      fail( "can't find the link containing text: #{linkText}")
-    end
-
-    def assert_link_not_present_with_text(linkText)
-      @web_browser.links.each { |link|
-        assert(!link.text.include?(linkText), "unexpected link containing: #{linkText} found")
-      }
-    end
-
-    def assert_text_present_in_text_field(textfieldName, text, msg = nil)
-      @web_browser.textfields.each { |textfield|
-        if (textfield.name == textfieldName) then
-          assert(text_field.value.include?(text), "text: #{text} not in text field: " + textfieldName)
-        end
-      }
-    end
-
-    # assertions
-    def assert_title_equals(title)
-      assert_equals(title, @web_browser.page_title)
-    end
-    alias assert_title assert_title_equals
 
     def assert_equals(expected, actual, msg=nil)
       assert(expected == actual, (msg.nil?) ? "Expected: #{expected} diff from actual: #{actual}" : msg)
     end
 
-    def assert_nil(actual, msg="")
-      assert(actual.nil?, msg)
-    end
 
-    def assert_not_nil(actual, msg="")
-      assert(!actual.nil?, msg)
-    end
 
-    def fail(message)
-      assert(false, message)
-    end
+    # Check a HTML element exists or not
+    # Example:
+    #  assert_exists("label", "receipt_date")
+    #  assert_exists(:span, :receipt_date)
+    def assert_exists(tag, element_id) {}
+      begin
+        assert eval("#{tag}(:id, '#{element_id.to_s}').exists?")
+      rescue => e
+        raise "Element '#{tag}' with id: '#{element_id}' not found, #{e}"
+      end
+    end
+    alias assert_exists? assert_exists
+    alias assert_element_exists assert_exists
+
+    def assert_not_exists(tag, element_id) {}
+      begin
+        assert_not eval("#{tag}(:id, '#{element_id.to_s}').exists?")
+        raise "Unexpected element'#{tag}' + with id: '#{element_id}' found"
+      rescue => e
+      end
+    end
+    alias assert_not_exists? assert_not_exists
+    alias assert_element_not_exists? assert_not_exists
+
+
+    # Assert tag with element id is visible?, eg. 
+    #   assert_visible(:div, "public_notice")
+    #   assert_visible(:span, "public_span")
+    def assert_visible(tag, element_id)
+      begin
+        assert(eval("#{tag}(:id, '#{element_id.to_s}').visible?"))
+      rescue => e
+        raise "Element '#{tag}' with id: '#{element_id}' not visible, #{e}"
+      end
+    end
+
+    # Assert tag with element id is hidden?, example 
+    #   assert_hidden(:div, "secret")
+    #   assert_hidden(:span, "secret_span")
+    def assert_hidden(tag, element_id)
+      begin
+        assert(!eval("#{tag}(:id, '#{element_id.to_s}').visible?"))
+      rescue => e
+        raise "Element '#{tag}' with id: '#{element_id}' is visible, #{e}"
+      end
+    end
+    alias assert_not_visible assert_hidden
+
+
+    # Assert given text appear inside a table (inside <table> tag like below) 
+    #
+    # <table id="t1">
+    #
+    # <tbody>
+    #   <tr id="row_1">
+    #     <td id="cell_1_1">A</td>
+    #     <td id="cell_1_2">B</td>
+    #   </tr>
+    #   <tr id="row_2">
+    #     <td id="cell_2_1">a</td>
+    #     <td id="cell_2_2">b</td>
+    #   </tr>
+    # </tbody>
+    #
+    # </table>
+    #
+    # The plain text view of above table
+    #  A B a b
+    # 
+    # Examples
+    #  assert_text_present_in_table("t1", ">A<")  # => true
+    #  assert_text_present_in_table("t1", ">A<", :just_plain_text => true)  # => false        
+    def assert_text_present_in_table(table_id, text, options = { :just_plain_text => false })
+      assert(table_source(table_id, options).include?(text),  "the text #{text} not found in table #{table_id}")
+    end
+    alias assert_text_in_table assert_text_present_in_table
+
+    def assert_text_not_present_in_table(table_id, text, options = { :just_plain_text => false })
+      assert_not(table_source(table_id, options).include?(text),  "the text #{text} not found in table #{table_id}")
+    end
+    alias assert_text_not_in_table assert_text_not_present_in_table
+
+    # Assert a text field (with given name) has the value
+    #
+    # <input id="tid" name="text1" value="text already there" type="text">
+    # 
+    # assert_text_field_value("text1", "text already there") => true
+    #
+    def assert_text_field_value(textfield_name, text)
+      assert_equal(text, text_field(:name, textfield_name).value)
+    end
+
+    
+    #-- Not tested
+    # -----
+    
+    def assert_text_in_element(element_id, text)
+      elem = element_by_id(element_id)
+      assert_not_nil(elem.innerText, "element #{element_id} has no text")
+      assert(elem.innerText.include?(text), "the text #{text} not found in element #{element_id}")
+    end
+
+    # Use 
+    #
 
+    #TODO for drag-n-drop, check the postion in list
+    #    def assert_position_in_list(list_element_id)
+    #      raise "not implemented"
+    #    end
+    
+    private
+    def table_source(table_id, options)
+   	  elem_table = table(:id, table_id.to_s)
+      elem_table_text = elem_table.text 
+      elem_table_html = is_firefox? ? elem_table.innerHTML : elem_table.html
+      table_source = options[:just_plain_text] ? elem_table_text : elem_table_html
+    end
+    
   end
 end

data/lib/rwebunit/context.rb

@@ -1,5 +1,5 @@
 #***********************************************************
-#* Copyright (c) 2006, 2007 Zhimin Zhan.
+#* Copyright (c) 2006 - 2009 Zhimin Zhan.
 #* Distributed open-source, see full license in MIT-LICENSE
 #***********************************************************