watir 1.4.1

data/watir/WindowHelper.rb

@@ -0,0 +1,47 @@
+require 'win32ole'
+
+class WindowHelper
+    def initialize( )
+        @autoit = WIN32OLE.new('AutoItX3.Control')
+    end
+    
+    def push_alert_button()
+        @autoit.WinWait "Microsoft Internet Explorer", ""
+        @autoit.Send "{ENTER}"
+    end
+    
+    def push_confirm_button_ok()
+        @autoit.WinWait "Microsoft Internet Explorer", ""
+        @autoit.Send "{ENTER}"
+    end
+    
+    def push_confirm_button_cancel()
+        @autoit.WinWait "Microsoft Internet Explorer", ""
+        @autoit.Send "{ESCAPE}"
+    end
+    
+    def push_security_alert_yes()
+        @autoit.WinWait "Security Alert", ""
+        @autoit.Send "{TAB}"
+        @autoit.Send "{TAB}"
+        @autoit.Send "{SPACE}"
+    end
+        
+    def logon(title,name = 'john doe',password = 'john doe')
+        @autoit.WinWait title, ""
+        @autoit.Send name
+        @autoit.Send "{TAB}"
+        @autoit.Send password
+        @autoit.Send "{ENTER}"
+    end
+    
+    def WindowHelper.check_autoit_installed
+        begin
+            WIN32OLE.new('AutoItX3.Control')
+        rescue
+            raise Watir::Exception::WatirException, "The AutoIt dll must be correctly registered for this feature to work properly"
+        end
+    end
+end
+
+

data/watir/camel_case.rb

@@ -0,0 +1,37 @@
+# These are provided for backwards compatability with Watir 1.1
+
+module Watir
+    module SupportsSubElements
+        alias waitForIE wait
+        alias fileField file_field
+        alias textField text_field
+        alias selectBox select_list
+        alias checkBox checkbox
+    end
+    class IE
+        alias getStatus status
+        alias getDocument document
+        alias pageContainsText contains_text
+        alias waitForIE wait
+        alias getHTML html
+        alias getText text
+        alias showFrames show_frames
+        alias showForms show_forms
+        alias showImages show_images
+        alias showLinks show_links
+        alias showActive show_active
+        alias showAllObjects show_all_objects
+    end
+    class Frame        
+        alias getDocument document
+        alias waitForIE wait
+    end
+    class Form        
+        alias waitForIE wait 
+    end
+    
+    class SpanDivCommon
+        alias innerText text
+    end    
+    
+end

data/watir/clickJSDialog.rb

@@ -0,0 +1,19 @@
+#
+#  clickJSDialog.rb 
+#
+#
+# This file contains the JS clicker when it runs as a separate process
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), '..'))
+puts $LOAD_PATH
+require 'watir/winClicker'
+
+button = "OK"
+button = ARGV[0] unless ARGV[0] == nil
+sleepTime = 0
+sleepTime = ARGV[1] unless ARGV[1] == nil
+
+
+clicker= WinClicker.new
+result = clicker.clickJavaScriptDialog( button )
+clicker = nil

data/watir/cookiemanager.rb

@@ -0,0 +1,53 @@
+
+    class Dir
+        def Dir.visit(dir = '.', files_first = false, &block)
+            if files_first
+                paths = []
+                Find.find(dir) { |path| paths << path }
+                paths.reverse_each {|path| yield path}
+            else
+                Find.find(dir, &block)
+            end
+        end
+        # simulates unix rm -rf command
+        def Dir.rm_rf(dir)
+            Dir.visit(dir, true) do |path|
+                if FileTest.directory?(path)
+                    begin
+                        Dir.unlink(path)
+                    rescue # Security Exception for Content.IE
+                    end
+                else
+                    begin
+                        File.unlink(path)
+                    rescue #Security exception index.dat etc.
+                    end
+                end
+            end
+        end
+    end
+
+module Watir
+  module CookieManager 
+    
+    class WatirHelper
+        #taken from shlObj.h  used in win32 SHGetSpecialFolderLocation
+        #define CSIDL_INTERNET_CACHE            0x0020
+        #define CSIDL_COOKIES                   0x0021
+        #define CSIDL_HISTORY                   0x0022
+        COOKIES = 0x0021
+        INTERNET_CACHE = 0x0020
+        
+        def  WatirHelper.getSpecialFolderLocation(specFolderName)
+            shell = WIN32OLE.new("Shell.Application")
+            folder = shell.Namespace(specFolderName)
+            folderItem = folder.Self
+            folderPath = folderItem.Path
+        end
+        def  WatirHelper.deleteSpecialFolderContents(specFolderName)
+            Dir.rm_rf(self.getSpecialFolderLocation(specFolderName))
+        end
+        
+    end
+  end  
+end

data/watir/exceptions.rb

@@ -0,0 +1,60 @@
+module Watir
+  module Exception
+
+    # Root class for all Watir Exceptions
+    class WatirException < RuntimeError  
+        def initialize(message="")
+            super(message)
+        end
+    end
+    
+    # This exception is thrown if an attempt is made to access an object that doesn't exist
+    class UnknownObjectException < WatirException
+    end
+    
+    # This exception is thrown if an attempt is made to access an object that is in a disabled state
+    class ObjectDisabledException   < WatirException
+    end
+    
+    # This exception is thrown if an attempt is made to access a frame that cannot be found 
+    class UnknownFrameException< WatirException
+    end
+    
+    # This exception is thrown if an attempt is made to access a form that cannot be found 
+    class UnknownFormException< WatirException
+    end
+    
+    # This exception is thrown if an attempt is made to access an object that is in a read only state
+    class ObjectReadOnlyException  < WatirException
+    end
+    
+    # This exception is thrown if an attempt is made to access an object when the specified value cannot be found
+    class NoValueFoundException < WatirException
+    end
+    
+    # This exception gets raised if part of finding an object is missing
+    class MissingWayOfFindingObjectException < WatirException
+    end
+
+    # This exception is raised if an attempt is made to access a table that doesn't exist
+    class UnknownTableException < WatirException
+    end
+
+    # this exception is raised if an attempt is made to  access a table cell that doesnt exist
+    class UnknownCellException < WatirException
+    end
+    
+    # This exception is thrown if the window cannot be found
+    class NoMatchingWindowFoundException < WatirException
+    end
+
+    # This exception is thrown if an attemp is made to acces the status bar of the browser when it doesnt exist
+    class NoStatusBarException < WatirException
+    end
+
+    # This exception is thrown if an http error, such as a 404, 500 etc is encountered while navigating
+    class NavigationException < WatirException
+    end
+
+  end
+end

data/watir/screen_capture.rb

@@ -0,0 +1,115 @@
+
+require 'Win32API'
+
+module Watir
+  module ScreenCapture
+    
+    KEYEVENTF_KEYUP = 0x2
+    SW_HIDE         = 0
+    SW_SHOW         = 5
+    SW_SHOWNORMAL   = 1
+    VK_CONTROL      = 0x11
+    VK_F4           = 0x73
+    VK_MENU         = 0x12
+    VK_RETURN       = 0x0D
+    VK_SHIFT        = 0x10
+    VK_SNAPSHOT     = 0x2C
+    VK_TAB      = 0x09
+    GMEM_MOVEABLE = 0x0002
+    CF_TEXT = 1
+
+    # this method saves the current window or whole screen as either a bitmap or a jpeg
+    # It uses paint to save the file, so will barf if a duplicate filename is selected, or  the path doesnt exist etc
+    #    * filename        - string  -  the name of the file to save. If its not fully qualified the current directory is used
+    #    * active_window   - boolean - if true, the whole screen is captured, if false,  just the active window is captured
+    #    * save_as_bmp     - boolean - if true saves the file as a bitmap, saves it as a jpeg otherwise
+    def screen_capture(filename , active_window_only=false, save_as_bmp=false)
+
+
+      keybd_event = Win32API.new("user32", "keybd_event", ['I','I','L','L'], 'V')
+      vkKeyScan = Win32API.new("user32", "VkKeyScan", ['I'], 'I')
+      winExec = Win32API.new("kernel32", "WinExec", ['P','L'], 'L')
+      openClipboard = Win32API.new('user32', 'OpenClipboard', ['L'], 'I')
+      setClipboardData = Win32API.new('user32', 'SetClipboardData', ['I', 'I'], 'I')
+      closeClipboard = Win32API.new('user32', 'CloseClipboard', [], 'I')
+      globalAlloc = Win32API.new('kernel32', 'GlobalAlloc', ['I', 'I'], 'I')
+      globalLock = Win32API.new('kernel32', 'GlobalLock', ['I'], 'I')
+      globalUnlock = Win32API.new('kernel32', 'GlobalUnlock', ['I'], 'I')
+      memcpy = Win32API.new('msvcrt', 'memcpy', ['I', 'P', 'I'], 'I')
+
+     
+      filename = Dir.getwd.tr('/','\\') + '\\' + filename unless filename.index('\\')
+
+      if active_window_only ==false
+          keybd_event.Call(VK_SNAPSHOT,0,0,0)   # Print Screen
+      else
+          keybd_event.Call(VK_SNAPSHOT,1,0,0)   # Alt+Print Screen
+      end 
+
+      winExec.Call('mspaint.exe', SW_SHOW)
+      sleep(1)
+     
+      # Ctrl + V  : Paste
+      keybd_event.Call(VK_CONTROL, 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?V), 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?V), 1, KEYEVENTF_KEYUP, 0)
+      keybd_event.Call(VK_CONTROL, 1, KEYEVENTF_KEYUP, 0)
+
+
+      # Alt F + A : Save As
+      keybd_event.Call(VK_MENU, 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?F), 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?F), 1, KEYEVENTF_KEYUP, 0)
+      keybd_event.Call(VK_MENU, 1, KEYEVENTF_KEYUP, 0)
+      keybd_event.Call(vkKeyScan.Call(?A), 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?A), 1, KEYEVENTF_KEYUP, 0)
+      sleep(1)
+
+      # copy filename to clipboard
+      hmem = globalAlloc.Call(GMEM_MOVEABLE, filename.length+1)
+      mem = globalLock.Call(hmem)
+      memcpy.Call(mem, filename, filename.length+1)
+      globalUnlock.Call(hmem)
+      openClipboard.Call(0)
+      setClipboardData.Call(CF_TEXT, hmem) 
+      closeClipboard.Call 
+      sleep(1)
+      
+      # Ctrl + V  : Paste
+      keybd_event.Call(VK_CONTROL, 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?V), 1, 0, 0)
+      keybd_event.Call(vkKeyScan.Call(?V), 1, KEYEVENTF_KEYUP, 0)
+      keybd_event.Call(VK_CONTROL, 1, KEYEVENTF_KEYUP, 0)
+
+      if save_as_bmp == false
+        # goto the combo box
+        keybd_event.Call(VK_TAB, 1, 0, 0)
+        keybd_event.Call(VK_TAB, 1, KEYEVENTF_KEYUP, 0)
+        sleep(0.5)
+
+        # select the first entry with J
+        keybd_event.Call(vkKeyScan.Call(?J), 1, 0, 0)
+        keybd_event.Call(vkKeyScan.Call(?J), 1, KEYEVENTF_KEYUP, 0)
+        sleep(0.5)
+      end  
+
+      # Enter key
+      keybd_event.Call(VK_RETURN, 1, 0, 0)
+      keybd_event.Call(VK_RETURN, 1, KEYEVENTF_KEYUP, 0)
+      sleep(1)
+     
+      # Alt + F4 : Exit
+      keybd_event.Call(VK_MENU, 1, 0, 0)
+      keybd_event.Call(VK_F4, 1, 0, 0)
+      keybd_event.Call(VK_F4, 1, KEYEVENTF_KEYUP, 0)
+      keybd_event.Call(VK_MENU, 1, KEYEVENTF_KEYUP, 0)
+      sleep(1) 
+
+    end
+  end
+
+end
+
+
+#screenCapture( "f.bmp", false , true)
+

data/watir/setFileDialog.rb

@@ -0,0 +1,16 @@
+#
+#  setFileDialog.rb 
+#
+#
+# This file contains the file dialog when it runs as a separate process
+
+$LOAD_PATH << File.expand_path(File.join(File.dirname(__FILE__), '..'))
+puts $LOAD_PATH
+require 'watir/winClicker'
+
+filepath = "invalid path passed to setFileDialog.rb"
+filepath = ARGV[0] unless ARGV[0] == nil
+
+clicker= WinClicker.new
+clicker.setFileRequesterFileName(filepath)
+clicker = nil

data/watir/testUnitAddons.rb

@@ -0,0 +1,47 @@
+
+        
+module Test::Unit::Assertions
+
+
+   def assert_false(boolean, message=nil)
+        _wrap_assertion do
+          assert_block("assert should not be called with a block.") { !block_given? }
+          assert_block(build_message(message, "<?> is not false.", boolean)) { !boolean }
+        end
+      end
+
+
+     def compareArrays( expectArray, actualArray)
+             result = true
+             expectArray.each_with_index do |element,i|
+                 #puts "Comparing #{element} #{element.class} with #{actualArray[i]} #{actualArray[i].class} "
+                 if element != actualArray[i]
+                     result = false
+                     break
+                 end
+            end  
+
+        return result
+
+    end
+
+    def assert_arrayEquals(expectArray, actualArray, message = nil )
+        _wrap_assertion do
+          assert_block("assert should not be called with a block.") { !block_given? }
+          assert_equal(expectArray.length, actualArray.length, "Lengths did not match")
+
+          assert_block("contents are different." ){  compareArrays( expectArray, actualArray)  }
+       end  #_wrap
+    end #def
+
+
+    def assert_arrayContains(array, string , message =nil)
+
+         _wrap_assertion do
+          assert_block("assert should not be called with a block.") { !block_given? }
+          assert(array.kind_of?(Array) , "Must have an array")
+          assert(array.include?(string) , message)
+        end
+    end
+
+end # module test

data/watir/watir_simple.rb

@@ -0,0 +1,475 @@
+=begin
+  license
+  ---------------------------------------------------------------------------
+  Copyright (c) 2004-2005, Atomic Object LLC
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+  1. Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+  2. Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+  3. Neither the name "Atomic Object LLC" nor the names of contributors to
+  this software may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+  IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR
+  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+  --------------------------------------------------------------------------
+  (based on BSD Open Source License)
+=end
+
+require 'test/unit/assertions'
+require 'watir'
+
+module Watir
+# = Description
+# Watir::Simple is a simple wrapper around the Watir module.  It provides a
+# similar set of operations while simplifying them and removing as much syntax
+# and test-framework context code as possible.
+# The goal is to allow toolsmiths to write domain-language frameworks on top of
+# Watir, using Watir::Simple as an easier, lightweight interface to the power
+# of Watir.
+#
+# = Note
+# Most action methods in Watir::Simple will automatically wait for the browser
+# not to be busy before and after they perform the specified action.
+#
+# revision: $Revision: 1.1 $
+  module Simple
+
+  # Open up a browser and point it at a certain URL.
+	def new_browser_at(url)
+		@@browser = IE.new
+		@@browser.typingspeed = 0
+		@@browser.goto url
+	end
+
+
+  # Tell the browser to load a particular URL.
+	def navigate_to(url)
+		@@browser.goto url
+	end
+
+
+  # Much like click_link_with_url but navigates to link instead of clicking it,
+  # thereby not invoking OnClick for links.
+  def navigate_to_link_with_url(url)
+    # FIXME: this should be moved into Watir!
+    wait_before_and_after do
+      doc = @@browser.getDocument()
+      links = doc.links
+      link = nil
+      links.each do |n|
+        match = false
+        case url
+        when Regexp
+          match = (n.invoke("href") =~ url)
+        when String
+          match = (n.invoke("href") == url)
+        end
+        if match
+          link = n
+          break
+        end
+      end
+      raise "Couldn't find link with url #{url}" unless link
+      @@browser.goto link
+    end
+  end
+
+  # Much like click_link_with_id but navigates to link instead of clicking it,
+  # thereby not invoking OnClick for links.
+  def navigate_to_link_with_id(id)
+    # FIXME: this should be moved into Watir!
+    wait_before_and_after do
+      doc = @@browser.getDocument()
+      links = doc.links
+      link = nil
+      links.each do |n|
+        match = false
+        case id
+        when Regexp
+          match = (n.invoke("id") =~ id)
+        when String
+          match = (n.invoke("id") == id)
+        end
+        if match
+          link = n
+          break
+        end
+      end
+      raise "Couldn't find link with id #{id}" unless link
+      @@browser.goto link
+    end
+  end
+
+  # Tell the browser to click on the first link with the specified URL.
+  # This takes the address of the link instead of the text displayed.
+  # * url - can be a string to match exactly, or a regular expression.
+  #
+  # Example:
+  #   click_link_with_url "http://google.com"
+  # or:
+  #   click_link_with_url /goo*/
+	def click_link_with_url(url)
+    wait_before_and_after { @@browser.link(:url, url).click }
+	end
+
+
+  # Tell the browser to click on the first link with the specified id attribute
+  # (the preferred method.)
+	def click_link_with_id(id)
+    wait_before_and_after { @@browser.link(:id, id).click }
+	end
+
+
+  # Tell the browser to click on the first link with the specified name attribute
+	def click_link_with_name(name)
+    wait_before_and_after { @@browser.link(:name, name).click }
+	end
+
+
+  # Tell the browser to click on the specified link as determined by the
+  # sequential ordering of links on the document.
+	def click_link_with_index(index)
+    wait_before_and_after { @@browser.link(:index, index).click }
+	end
+
+
+  # Tell the browser to click on the first link with the specified text in the
+  # link body.
+	def click_link_with_text(text)
+    wait_before_and_after { @@browser.link(:text, text).click }
+	end
+
+
+  # Set the text of the field with a given name  (the preferred method.)
+  # This only types characters into the field and does not submit the form.
+	def enter_text_into_field_with_name(name, text)
+    wait_before_and_after { @@browser.textField(:name, name).set(text) }
+	end
+
+
+  # Set the text of the field with a given id attribute (the preferred method.)
+  # This only types characters into the field and does not submit the form.
+	def enter_text_into_field_with_id(id, text)
+    wait_before_and_after { @@browser.textField(:id, id).set(text) }
+	end
+
+
+  # Set the text of the indexed field.  This only types characters
+  # into the field and does not submit the form.
+	def enter_text_into_field_with_index(index, text)
+    wait_before_and_after { @@browser.textField(:index, index).set(text) }
+	end
+
+
+  # Select an item from a selectbox (a.k.a "combo box", or "pulldown")
+  # The selectbox is chose by matching its name attribute.
+  # The item is selected based on the text content of <OPTION> tags.
+	def select_from_combobox_with_name(name, text)
+		wait_before_and_after {	@@browser.selectBox(:name, name).select(text) }
+	end
+
+
+  # Select an item from a selectbox (a.k.a "combo box", or "pulldown")
+  # The selectbox is chose by matching its id attribute.
+  # The item is selected based on the text content of <OPTION> tags.
+  def select_from_combobox_with_id(id, text)
+		wait_before_and_after {	@@browser.selectBox(:id, id).select(text) }
+	end
+
+
+  # Select an item from a selectbox (a.k.a "combo box", or "pulldown")
+  # The selectbox is chose by matching its order of appearance in the
+  # document.
+  # The item is selected based on the text content of <OPTION> tags.
+  def select_from_combobox_with_index(index, text)
+		wait_before_and_after {	@@browser.selectBox(:index, index).select(text) }
+	end
+
+
+  # Select an item (+value+) from the radio button collection with +name+.
+	def select_radio_button_with_name(name, value)
+		wait_before_and_after {	@@browser.radio(:name, name, value).click }
+	end
+
+
+  # Select an item (+value+) from the +index+'th radio button collection.
+	def select_radio_button_with_name(index, value)
+		wait_before_and_after {	@@browser.radio(:index, index, value).click }
+	end
+
+
+  # Select an item (+value+) from the radio button collection with a matching
+  # +id+ attribute.
+	def select_radio_button_with_id(id, value)
+    wait_before_and_after {	@@browser.radio(:id, id, value).click }
+	end
+
+
+  # Tell the browser to click on a form button with +name+.
+  def click_button_with_name(name)
+    wait_before_and_after {	@@browser.button(:name, name).click }
+	end
+
+
+  # Tell the browser to click on a form button with the specified id attribute.
+	def click_button_with_id(id)
+		wait_before_and_after {	@@browser.button(:id, id).click }
+	end
+
+
+  # Tell the browser to click on a form button with the specified value attribute.
+	def click_button_with_value(value)
+		wait_before_and_after {	@@browser.button(:value, value).click }
+	end
+
+
+  # Tell the browser to click on a form button with the specified caption text.
+	def click_button_with_caption(caption)
+		wait_before_and_after {	@@browser.button(:caption, caption).click }
+	end
+
+
+  # Tell the browser to click on the +index+'th form button on the page.
+	def click_button_with_index(index)
+		wait_before_and_after {	@@browser.button(:index, index).click }
+	end
+
+
+  # Make a Test::Unit assertion that the given +text+ does not appear in the text
+  # body.
+  #
+  # * mesg - An assertion-failed message.
+	def assert_text_not_in_body(text,mesg=nil)
+		if mesg.nil? then
+			assert(! @@browser.pageContainsText(text), "couldn't find in body: [#{text}]")
+		else
+			assert(! @@browser.pageContainsText(text), mesg)
+		end
+	end
+
+
+  # Make a Test::Unit assertion that the given +text+ appears in the text
+  # body.
+  #
+  # * text - +String+ or +RegExp+ - The text or regular expression to search for.
+  # * mesg - +String+             - An optional assertion-failed message.
+	def assert_text_in_body(text,mesg=nil)
+		if mesg.nil? then
+			assert(@@browser.pageContainsText(text), "couldn't find in body: [#{text}]")
+		else
+			assert(@@browser.pageContainsText(text), mesg)
+		end
+	end
+
+
+  # This method returns true|false if the text/reg exp supplied is in a the text field "name".
+  #
+  # * name - +String+            - Name of field to examine.
+  # * text - +String+ or +RegExp+ - The text or regular expression to search for.
+  # * mesg - +String+            - An optional assertion-failed message.
+	def assert_text_in_field(name, text, mesg=nil)
+    if mesg.nil? then
+      assert(@@browser.textField(:name, name).verify_contains(text), "couldn't find in field #{name}: [#{text}]")
+    else
+      assert(@@browser.textField(:name, name).verify_contains(text), mesg)
+    end
+	end
+
+	#
+	# * how - symbol - the way we look for the object. Supported values are
+	#                - :name
+	#                - :id
+	#                - :index          
+	# * what - string                      - What field, id or name to examine.
+	# * text - string/Array of Strings     - The string or array of strings to search for.
+	# * mesg - Optional! string            - Set this if you want to supply your own error message
+ 	def assert_text_in_combobox_wrapper(how, what, text, mesg=nil)
+		assert(@@browser.selectBox(how, what), "could not find a combobox with what: #{what} and how: #{how}")
+		selectedItems = @@browser.selectBox(how, what).getSelectedItems
+		
+		if text.kind_of? String
+			if mesg.nil? then
+				assert(selectedItems[0] == text, "couldn't find text in combobox with #{how}: #{what} - [#{text}], had [#{selectedItems[0]}]")
+			else
+				assert(selectedItems[0] == text, mesg)
+			end
+			
+		elsif text.kind_of? Array
+			if mesg.nil? then
+				text.each do |item|
+					assert(selectedItems.include?(item), "couldn't find text in combobox  with #{how}: #{what} - [#{text}], had [#{selectedItems}]")
+				end
+			else
+				text.each do |item|
+					assert(selectedItems.include?(item), mesg)
+				end
+			end
+		end
+	end
+	
+
+	# This method returns true|false if the text is selected in the combobox
+	# with the supplied name.
+	#
+	# * name - string                      - Name of field to examine.
+	# * text - string/Array of Strings     - The string or array of strings to search for.
+	# * mesg - Optional! string            - Set this if you want to supply your own error message
+	def assert_text_in_combobox_by_name(name, text, mesg=nil)
+		assert_text_in_combobox_wrapper(:name, name, text, mesg)
+	end
+
+	# FIXME: how to use?
+	# This method returns true|false if the text is selected in the combobox
+	# with the supplied index.
+	#
+	# * index - string                     - Index of field to examine.
+	# * text - string/Array of Strings     - The string or array of strings to search for.
+	# * mesg - Optional! string            - Set this if you want to supply your own error message
+	#def assert_text_in_combobox_by_index(index, text, mesg=nil)
+	#	assert_text_in_combobox_wrapper(:index, name, text, mesg)
+	#end
+
+	# This method returns true|false if the text is selected in the combobox
+	# with the supplied id.
+	#
+	# * id - string                        - Id of field to examine.
+	# * text - string/Array of Strings     - The string or array of strings to search for.
+	# * mesg - Optional! string            - Set this if you want to supply your own error message
+	def assert_text_in_combobox_by_id(id, text, mesg=nil)
+		assert_text_in_combobox_wrapper(:id, name, text, mesg)
+	end
+
+
+
+  # Close the browser window.  Useful for automated test suites to reduce
+  # test interaction.
+	def close_browser
+		@@browser.getIE.quit
+		sleep 2
+	end
+
+
+  # Tell the browser to cick the Back button.
+	def go_back
+		@@browser.back
+	end
+
+
+  # Tell the browser to cick the Forward button.
+	def go_forward
+		@@browser.forward
+	end
+
+
+  # Fill a series of text fields.  This takes a hash of textfield names to
+  # values for those fields.
+  #
+  # Example:
+  #
+  #   fill_text_fields {
+  #     'username' => 'joe',
+  #     'password' => 'blahblah',
+  #     'email' => 'joe@blahblah.com',
+  #     'favorite_num' => 42
+  #   }
+	def fill_text_fields(data)
+		data.each do |field, value|
+			@@browser.textField(:name, field).set(value)
+		end
+	end
+
+
+  # Fill a single textfield with a value
+	def fill_text_field(field_name, text)
+		@@browser.textField(:name, field_name).set(text)
+	end
+
+
+  # Some browsers (i.e. IE) need to be waited on before more actions can be
+  # performed.  Most action methods in Watir::Simple already call this before
+  # and after.
+	def wait_for_browser
+		@@browser.waitForIE
+	end
+
+
+	def combobox_default_selection(name)
+    # FIXME _where_ is this used?
+		@@browser.selectBox(:name, name).value
+	end
+
+
+  # Returns the number of times +text+ appears in the body text of the page.
+	def count_instances_of(text)
+		@@browser.getDocument.body.innerText.scan(text).size
+	end
+
+
+  # Make a Test::Unit assertion that an image exists on the page with the given
+  # +src+ attribute.
+  #
+  # * mesg - +String+            - An optional assertion-failed message.
+	def assert_image_with_src(src, mesg=nil)
+		if mesg.nil? then
+			assert( get_image_with_src(src) != nil, "image with src: [#{src}] is not present")
+		else
+			assert( get_image_with_src(src) != nil, mesg)
+		end
+	end
+
+
+  # Make a Test::Unit assertion that an image exists on the page with the given
+  # +id+ attribute. (Preferred method)
+  #
+  # * mesg - +String+            - An optional assertion-failed message.
+	def assert_image_with_id(id, mesg=nil)
+		if mesg.nil? then
+			assert( get_image_with_id(id) != nil, "image with id: [#{id}] is not present")
+		else
+			assert( get_image_with_id(id) != nil, mesg)
+		end
+	end
+
+
+  # A convenience method to wait at both ends of an operation for the browser
+  # to catch up.
+  def wait_before_and_after
+    wait_for_browser
+    yield
+    wait_for_browser
+  end
+
+
+  #### PRIVATE METHODS BEYOND THIS POINT
+  private
+  ####
+
+	def get_image_with_src(src)
+    @@browser.image(:src, src)
+	end
+
+
+	def get_image_with_id(id)
+	  @@browser.image(:id, id)
+	end
+
+  end
+end