watir 1.4.1 → 1.5.2

data/bin/watir-console

@@ -0,0 +1 @@
+exec 'irb.bat -r irb/completion -r watir/irb-history -r watir --simple-prompt --readline'

data/changes.rb

@@ -0,0 +1,119 @@
+=begin rdoc
+Major Changes in 1.5
+    Support for IE's Modal Dialogs. 
+      showModalDialog() 
+    Any method can be used to specify an element (:text, :class, etc.). 
+      ie.button(:class,'Button Menu').click
+      ie.div(:text, 'Type').text_field(:class, 'TextInput-input').set('my value')
+      ie.button(:text, 'Save').click 
+    One can now use multiple attributes to specify an element.
+      ie.span(:class =>'Label', :text => 'Add new').click
+      
+Other Changes in 1.5  
+    * Migrated IE.new_process from watir/contrib and improved its reliability. We now recommend IE.new_process over IE.new as a way to avoid numerous errors detailed in http://jira.openqa.org/browse/WTR-150.
+    * Added IE.start_process. This works like IE.start, but uses the new_process mechanism to start IE.
+    * Added IE.new_window and IE.start_window. This are synonyms for IE.new and IE.start.
+    * Added dependency on the win32-process gem.
+    * Added IE.each, which iterates through the various IE windows currently open.
+    * Updated WindowHelper and watir/dialog to work with IE7
+    * The wait method was completely rewritten. This should fix various errors seen in 1.5.1.1165 and 1.5.1.1158.
+    * Removed the "spinner".
+    * Fixed bug in Element#parent and updated unit test.
+    * HTML value attributes are checked as strings before converting, updated unit tests.
+    * Watir::wait_until clean up.
+    * Fix for winclicker when installed in directory with spaces.
+    * Rdoc changes and updates.
+    * A workaround for frame access errors in the wait command, swallowing access denied errors and rethrowing if other WIN32OLERuntimeErrors show up.
+    * Add support for "li" tag.
+    * Fix for bug in element_by_xpath. http://www.mail-archive.com/wtr-general@rubyforge.org/msg06742.html
+    * "Wait" method now is called recursively into nested frames. http://jira.openqa.org/browse/WTR-107
+    * Rdocs now only include the core Watir library (not contrib).
+    * Improve error reporting when IE#modal_dialog isn't found.
+    * Add method "ModalDialog#exists?"
+    * Add Watir::Win32.window_exists? method.
+    * Fix for winclicker setComboBoxTest and setTextBoxText http://jira.openqa.org/browse/WTR-124
+    * Improved Support for IE7
+        o Fix for IE7 on ie.exists? http://jira.openqa.org/browse/WTR-123
+        o Fix for IE7 with winclicker.
+        o Fix for check_for_http_error in IE7. http://jira.openqa.org/browse/WTR-141
+    *  Fix for IE7 on ie.exists? http://jira.openqa.org/browse/WTR-123
+    * Rubyw is now used in winclicker to bypass command line windows.
+    * Autoit is registered before being used.
+    * Watir now checks for the right version of Ruby before loading our customized Win32ole library.
+    * ie.file_field has been fixed and unit test updated.
+    * rdoc generation has been fixed.
+    * page checker has been moved from the default behavior into contrib/page_checker.rb
+    * Fix for intermittent crashes occuring when using Watir with Ruby version > 1.8.2.
+    * Fix for http://jira.openqa.org/browse/WTR-86
+        This fix prevents the Watir-modified win32ole.so library (compiled against 1.8.2) from being used.
+    * Added Element#parent
+    * Add new methods Element#after? and Element#before?
+    * Added support for relative specifiers. E.g.:
+        link = $ie.link(:class => 'addtocart', :after? => @headline)
+    * Removed NAVIGATION_CHECKER from Watir.rb, added to contrib. This fixes rdoc generation and stops the frame access exception being thrown in the default installation.
+    * Open-code calls to def_creator, for easier debugging and rdoc generation of factory methods.
+    * Winclicker fix for too many callbacks defined error.
+    * Patch for rspec API changes
+    * You can now reference an iframe using IE#frame(:id, 'whatever'). Jira 109
+    * Added 'map' and 'area' element support.
+    * Moved Watir::Assertions into new file watir/assertions.rb so they can be used outside test cases.
+    * Fix and unit test for Jira 114, related to tag in HTML source.
+    * Added SelectList#include? and SelectList#selected?
+    * Added Element#visible?
+    * Fixes all reported bugs with contains_text.
+    * New Watir::TestCase#verify method (and verify_equal and verify_match).
+    * The click_no_wait method now works in frames.
+    * Released new IE.new_process method to 'watir/contrib/ie-new-process'. This starts up a new IE process for each IE window, which is really how it should be done. To close these use IE#kill. Any one getting intermittent RPC errors when opening windows may want to use this instead.
+    * Several examples have been updated.
+    * Moved enabled_popup to a new contrib directory.
+    * Added several tests. 
+
+Changes in 1.4
+   fix method name for accessing class name of P/Span/Div (change from style to class_name)
+   fix for bug 2152 (frame index in show_frames off by 1)
+   added alt as a property to image
+   added file_fields
+   fixed TextArea#to_s
+   moved reset button to buttons class
+   add IE#send_keys
+   frames can now be referenced using regexps and ids
+   added IE#minimize, IE#maximize, IE#restore
+   onChange and onBlur events now triggered by TextField#set
+   added default option to set for checkbox
+   added colspan method to tablecell
+   fix for bug reported by Scott P, wrong objects are sometimes found
+   fixed Bug with radio/checkboxes doing multiple fireevents
+   fix for table, id and reg exp
+   wait for page load before returning from IE.attach
+   update to select_list -- new interface still in progress
+   added .show method to iterators
+   fix for flashing objects in table cells
+   added flash for forms
+   flash returns nil instead of the curious '10'
+   removed ScreenCapture module from IE class
+
+Changes in 1.3.1
+   Added P tag support
+   Bug fix for images and links in frames using each
+   Bug fixes for image#save
+
+Changes in 1.3
+   added new row_values and column_value methods to tables
+   added ability to save an image - ie.image(:index,1).save('c:\temp\mypic.gif')
+   new method, html that applies to objects, not just a page - ie.button(:index,1).html => <INPUT id=b2 title="this is button1" onclick="javascript:document.location='pass.html';" type=button value="Click Me" name=b1>
+   now throws a NavigationException on 404, 500 errors
+   iterators now mixin Enumerable
+   added support for labels
+   added support for frames by index
+   added screen_capture
+   added hidden field support, and iterator method
+   table cells, span and div now act as containers, so can do ie.div(:index,1).button(:index.2).click
+   added index to print out from show_xx methods. Link shows img src if an image is used
+   added onKeyUp and onKeyDown to text_fields#set
+   installer now installs AutoIt to deal with javascript popups, file uploads etc
+   the spinner is now off by default 
+   bug fix in text_fields iterator where it wasnt iterating through password or text ares. Added test for password fields
+   bug fix for flash for tables
+   bug fixes for images and links in cells
+   
+=end

data/license.rb

@@ -0,0 +1,37 @@
+=begin rdoc
+
+License
+  ---------------------------------------------------------------------------
+  Copyright (c) 2004-2007, Paul Rogers and Bret Pettichord
+  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 names Paul Rogers, Bret Pettichord 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
+

data/readme.rb

@@ -2,101 +2,61 @@
 
 This is Watir - Web Application Testing In Ruby    http://wtr.rubyforge.org
 
-To Install:
-   Execute install.rb. 
+To Install Ruby:    http://ruby-lang.org
+   Best is to use Ruby 1.8.2-14 or later.
+   However, if you are using the Watir::IE#modal_dialog method, you must use Ruby 1.8.2-14 and not a more recent version.
+   Watir (in general) will not work with Ruby 1.8.1-13. (This version of Ruby has a bad WIN32OLE library.)
+
+To Install Watir:
+   Best way to install is to use the gem.
+   From your command line: 
+     > gem install win32-process --include-dependencies
+     > gem install watir
+   This will download and install watir, win32-process and all dependencies.
 
 How To Use:
-   This only works on Windows. It has been tested on Windows 2000 and XP.
-   Best is to use Ruby 1.8.2-14 or later.
-   This has been developed and tested using Ruby 1.8.1-11, Ruby 1.8.1-12.
-   It will NOT work with Ruby 1.8.1-13. (This version of Ruby has a bad WIN32OLE library.)
+   This only works on Windows.
    Requires Internet Explorer 5.5 or newer.
    Check out the mail lists and the documentation for the workarounds.
-   Install ruby from http://ruby-lang.org
+
+User Guide:    http://wiki.openqa.org/display/WTR/User+Guide
 
 Unit Tests:
    Run the unittests in a cmd shell. Go to the dir where you installed it and then type 'ruby unittests/core_tests.rb'.
    See the user guide if you are having problems with security blocking.
 
-Changes in 1.4.1
-    (based on watir.rb revision 1.215)
-    removed annoying warning message that sometimes appeared
-    corrected Element#class_name references which has been misnamed Element#style
-    removed IE#capture_events (didn't really work)
-    added IE#bring_to_front and IE#front?
-    fixed failing frame tests
-    remove failing test for disabled images
-    better rdoc
-    
-Changes in 1.4.0
-    fix method name for accessing class name of P/Span/Div (change from style to class_name)
-    fix for bug 2152 (frame index in show_frames off by 1)
-    added alt as a property to image
-    added file_fields
-    fixed TextArea#to_s
-    moved reset button to buttons class
-    add IE#send_keys
-    frames can now be referenced using regexps and ids
-    added IE#minimize, IE#maximize, IE#restore
-    onChange and onBlur events now triggered by TextField#set
-    added default option to set for checkbox
-    added colspan method to tablecell
-    fix for bug reported by Scott P, wrong objects are sometimes found
-    fixed bug with radio/checkboxes doing multiple fireevents
-    fix for table, id and reg exp
-    wait for page load before returning from IE.attach
-    update to select_list -- new interface still in progress
-    added .show method to iterators
-    fix for flashing objects in table cells
-    added flash for forms
-    flash returns nil instead of the curious '10'
-    removed ScreenCapture module from IE class
-
-Changes in 1.3.1
-   Added P tag support
-   Bug fix for images and links in frames using each
-   Bug fixes for image#save
-
-Changes in 1.3
-   added new row_values and column_value methods to tables
-   added ability to save an image - ie.image(:index,1).save('c:\temp\mypic.gif')
-   new method, html that applies to objects, not just a page - ie.button(:index,1).html => <INPUT id=b2 title="this is button1" onclick="javascript:document.location='pass.html';" type=button value="Click Me" name=b1>
-   now throws a NavigationException on 404, 500 errors
-   iterators now mixin Enumerable
-   added support for labels
-   added support for frames by index
-   added screen_capture
-   added hidden field support, and iterator method
-   table cells, span and div now act as containers, so can do ie.div(:index,1).button(:index.2).click
-   added index to print out from show_xx methods. Link shows img src if an image is used
-   added onKeyUp and onKeyDown to text_fields#set
-   installer now installs AutoIt to deal with javascript popups, file uploads etc
-   the spinner is now off by default 
-   bug fix in text_fields iterator where it wasnt iterating through password or text ares. Added test for password fields
-   bug fix for flash for tables
-   bug fixes for images and links in cells
-
 Typical Usage
    # include the controller 
    require 'watir' 
    # create an instance of the controller 
    ie = Watir::IE.new  
    # go to the page you want to test 
-   ie.goto("http://myserver/mypage") 
-   # to enter text into a text field - assuming the field is name "username" 
-   ie.text_field(:name, "username").set("Paul") 
-   # if there was a text field that had an id of "company_ID", you could set it to Ruby Co: 
-   ie.text_field(:id ,"company_ID").set("Ruby Co") 
+   ie.goto('http://myserver/mypage') 
+   # to enter text into a text field - assuming the field is named 'username' 
+   ie.text_field(:name, 'username').set('Paul') 
+   # if there was a text field that had an id of 'company_ID', you could set it to 'Ruby Co': 
+   ie.text_field(:id ,'company_ID').set('Ruby Co') 
    # to click a button that has a caption of 'Cancel' 
-   ie.button(:value, "Cancel").click 
+   ie.button(:value, 'Cancel').click 
+
+  Identifying something using two or more identifying characteristics
+   # Html objects can also be identified via a combination of two of the above methods, 
+   # for example to click a span with a class name of 'Label', and whose text is 'Add new', one could say
+   ie.span(:class =>'Label', :text => 'Add new').click
+   # Or to find one object within another (for example the first text_field within a div of class 
+   # 'PasswordInput', where your password equals 'MyPassword'), one could say
+   ie.div(:class, 'PasswordInput').text_field(:index, 1).set('MyPassword')
    
   The ways that are available to identify an html object depend upon the object type, but include
-   :id           used for an object that has an ID attribute -- this is the best way!
-   :name         used for an object that has a name attribute. 
-   :value        value of text fields, captions of buttons 
+   :id           used for an object that has an ID attribute.*
+   :name         used for an object that has a name attribute.*
+   :value        value of text fields, captions of buttons. 
    :index        finds the nth object of the specified type - eg button(:index , 2) finds the second button. This is 1 based. <br>
-   :beforeText   finds the object immeditaley before the specified text. Doesnt work if the text is in a table cell
-   :afterText    finds the object immeditaley after the specified text. Doesnt work if the text is in a table cell
+   :class        used for an object that has a class attribute.
+   :text         used for links and other objects that contain text.
+   :xpath        finds the item using xpath query
+
+   * :id and :name are the quickest of these to process, and so should be used when possible to speed up scripts.
 
   The objects that are currently supported include
    Button
@@ -121,18 +81,18 @@ Typical Usage
 
   -b  (background)   Run Internet Explorer invisible
   -f  (fast)         Run tests very fast
-  -x  (spinner)      Add a spinner that displays when pages are waiting to be loaded.
   
  Note that if you also use test/unit, you will need to require 'watir' first to avoid conflicts
  with its command line switches.
 
 Javascript Pop Up Support
-   Watir now installs AutoIt - http://www.autoitscript.com/
-   This is the preffered method for dealing with pop ups, file requesters etc. Support for Winclickers will be removed.
+   Watir now optionally installs AutoIt - http://www.autoitscript.com/
+   This is the prefered method for dealing wth pop ups, file requesters etc. Support for Winclickers will be removed.
 
 Contacts:
    Paul Rogers (paul.rogers@shaw.ca)
    Bret Pettichord (bret@pettichord.com)
+   Charley Baker (charley.baker@gmail.com)
    The mailing list: http://rubyforge.org/mail/?group_id=104
 
 Contributors:
@@ -146,9 +106,8 @@ Contributors:
    Justin McCarthy
    Chris McMahon
    Elisabeth Hendrickson
-   Michael Kelly (Indianapolis)
+   Michael Kelly
    Peter Chau
-   Jacinda Scott
    Danny Faught
    Andy Sipe
    John Lloyd-Jones
@@ -158,7 +117,20 @@ Contributors:
    Jared Luxenberg
    Alexey Verkhovsky
    Tuyet Cong-Ton-Nu
-   Kingsley Hendrickse
+   Jeff Wood
+   Angrez Singh
+   Abhishek Goliya
+   Yaxin Wang
+   Michael Bolton
+   Paul Carvalho
+   Konstantin Sobolev
+   David Schmidt 
+   Dara Lillis
+   Charley Baker
+   Prema Arya
+   Xavier Noria
+   Jeff Fry
+   Zeljko Filipin
 
 Acknowledgements:
    Chris Morris
@@ -167,45 +139,8 @@ Acknowledgements:
    Penny Tonita
    Janet Gregory
    Andy Tinkham
+   Jacinda Scott (logo creator)
 
    Thanks for your ideas and support!
 
-License
-  ---------------------------------------------------------------------------
-  Copyright (c) 2004-2005, Paul Rogers and Bret Pettichord
-  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 names Paul Rogers, Bret Pettichord 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
-class ReadMe
-end

data/unittests/buttons_test.rb

@@ -1,131 +1,134 @@
 # feature tests for Buttons
-# revision: $Revision: 1.32 $
+# revision: $Revision: 962 $
 
 $LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..') if $0 == __FILE__
 require 'unittests/setup'
 
 class TC_Buttons < Test::Unit::TestCase
-    include Watir
-    
-    def setup
-        $ie.goto($htmlRoot + "buttons1.html")
-    end
-    
-    def goto_frames_page()
-        $ie.goto($htmlRoot + "frame_buttons.html")
-    end
-    
-    def aatest_Spinner
-        s = Spinner.new
-        i = 0
-        while(i < 100)
-            sleep 0.05
-            print s.next
-            i+=1
-        end
-        s = nil
+  include Watir
+  
+  def setup
+    $ie.goto($htmlRoot + "buttons1.html")
+  end
+  
+  def goto_frames_page
+    $ie.goto($htmlRoot + "frame_buttons.html")
+  end
+  
+  def aatest_Spinner
+    s = Spinner.new
+    i = 0
+    while(i < 100)
+      sleep 0.05
+      print s.next
+      i+=1
     end
+    s = nil
+  end
+  
+  def aaatest_Button_to_s
+    # i think the tests for to_s should be dropped. The output is not in a nice format to be tested, and the
+    # individual properties are tested in the test_properties method
     
-    def aaatest_Button_to_s
-        # i think the tests for to_s should be dropped. The output is not in a nice format to be tested, and the
-        # individual properties are tested in the test_properties method
-        
-        b4 = ['name              b4',
+    b4 = ['name              b4',
         'type              button',
         'id                b5',
         'value             Disabled Button',
         'disabled          true']
-        b1 = ['name              b1',
+    b1 = ['name              b1',
         'type              button',
         'id                b2',
         'value             Click Me',
         'disabled          false']
-        
-        assert_equal(b4, $ie.button(:name, "b4").to_s)
-        assert_equal(b1, $ie.button(:caption, "Click Me").to_s)
-        assert_equal(b1, $ie.button(:index, 1).to_s)
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").to_s   }  
-    end
     
-    def test_properties
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").id   }  
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").name   }  
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").disabled   }  
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").type   }  
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").value   }  
-        
-        assert_equal("b1"  , $ie.button(:index, 1).name  ) 
-        assert_equal("b2"  , $ie.button(:index, 1).id  ) 
-        assert_equal("button"  , $ie.button(:index, 1).type  ) 
-        assert_equal("Click Me"  , $ie.button(:index, 1).value  ) 
-        assert_equal(false  , $ie.button(:index, 1).disabled  ) 
-        
-        assert_equal("b1"  , $ie.button(:id, "b2").name  ) 
-        assert_equal("b2"  , $ie.button(:id, "b2").id  ) 
-        assert_equal("button"  , $ie.button(:id, "b2").type  ) 
-        
-        assert_equal("b4"  , $ie.button(:index, 2).name  ) 
-        assert_equal("b5"  , $ie.button(:index, 2).id  ) 
-        assert_equal("button"  , $ie.button(:index, 2).type  ) 
-        assert_equal("Disabled Button"  , $ie.button(:index, 2).value  ) 
-        assert_equal(true  , $ie.button(:index, 2).disabled  ) 
-        
-        assert_equal( "" , $ie.button(:index, 2).title )
-        assert_equal( "this is button1" , $ie.button(:index, 1).title )
-    end
+    assert_equal(b4, $ie.button(:name, "b4").to_s)
+    assert_equal(b1, $ie.button(:caption, "Click Me").to_s)
+    assert_equal(b1, $ie.button(:index, 1).to_s)
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").to_s   }  
+  end
+  
+  def test_properties
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").id   }  
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").name   }  
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").disabled   }  
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").type   }  
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").value   }  
     
+    assert_equal("b1"  , $ie.button(:index, 1).name ) 
+    assert_equal("b2"  , $ie.button(:index, 1).id ) 
+    assert_equal("button"  , $ie.button(:index, 1).type  ) 
+    assert_equal("Click Me"  , $ie.button(:index, 1).value  ) 
+    assert_equal(false  , $ie.button(:index, 1).disabled  ) 
+    assert_equal("italic_button"  , $ie.button(:name, "b1").class_name  ) 
+    assert_equal(""  , $ie.button(:name , "b4").class_name  ) 
     
-    def test_button_using_default
-        # since most of the time, a button will be accessed based on its caption, there is a default way of accessing it....
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button( "Missing Caption").click   }  
-        
-        $ie.button("Click Me").click
-        assert($ie.contains_text("PASS") )
-    end
     
-    def test_Button_click_only
-        $ie.button(:caption, "Click Me").click
-        assert($ie.contains_text("PASS") )
-    end
+    assert_equal("b1"  , $ie.button(:id, "b2").name  ) 
+    assert_equal("b2"  , $ie.button(:id, "b2").id  ) 
+    assert_equal("button"  , $ie.button(:id, "b2").type  ) 
     
-    def test_button_click
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:caption, "Missing Caption").click   }  
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:id, "missingID").click   }  
-        
-        assert_raises(ObjectDisabledException , "ObjectDisabledException was supposed to be thrown" ) {   $ie.button(:caption, "Disabled Button").click   }  
-        
-        $ie.button(:caption, "Click Me").click
-        assert($ie.contains_text("PASS") )
-    end
+    assert_equal("b4"  , $ie.button(:index, 2).name  ) 
+    assert_equal("b5"  , $ie.button(:index, 2).id  ) 
+    assert_equal("button"  , $ie.button(:index, 2).type  ) 
+    assert_equal("Disabled Button"  , $ie.button(:index, 2).value  ) 
+    assert_equal(true  , $ie.button(:index, 2).disabled  ) 
     
-    def test_Button_Exists
-        assert($ie.button(:caption, "Click Me").exists?)   
-        assert($ie.button(:caption, "Submit").exists?)   
-        assert($ie.button(:name, "b1").exists?)   
-        assert($ie.button(:id, "b2").exists?)   
-        assert($ie.button(:caption, /sub/i).exists?)   
-        
-        assert_false($ie.button(:caption, "missingcaption").exists?)   
-        assert_false($ie.button(:name, "missingname").exists?)   
-        assert_false($ie.button(:id, "missingid").exists?)   
-        assert_false($ie.button(:caption, /missing/i).exists?)   
-    end
+    assert_equal( "" , $ie.button(:index, 2).title )
+    assert_equal( "this is button1" , $ie.button(:index, 1).title )
+  end
+  
+  
+  def test_button_using_default
+    # since most of the time, a button will be accessed based on its caption, there is a default way of accessing it....
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button( "Missing Caption").click   }  
     
-    def test_Button_Enabled
-        assert($ie.button(:caption, "Click Me").enabled?)   
-        assert_false($ie.button(:caption, "Disabled Button").enabled?)   
-        assert_false($ie.button(:name, "b4").enabled?)   
-        assert_false($ie.button(:id, "b5").enabled?)   
-        
-        assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").enabled?  }  
-    end
+    $ie.button("Click Me").click
+    assert($ie.text.include?("PASS") )
+  end
+  
+  def test_Button_click_only
+    $ie.button(:caption, "Click Me").click
+    assert($ie.text.include?("PASS") )
+  end
+  
+  def test_button_click
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:caption, "Missing Caption").click   }  
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:id, "missingID").click   }  
     
-    def test_frame
-        goto_frames_page()
-        
-        assert($ie.frame("buttonFrame").button(:caption, "Click Me").enabled?)   
-        assert_raises(  UnknownObjectException , "UnknownObjectException was supposed to be thrown ( no frame name supplied) " ) { $ie.button(:caption, "Disabled Button").enabled?}  
-    end
+    assert_raises(ObjectDisabledException , "ObjectDisabledException was supposed to be thrown" ) {   $ie.button(:caption, "Disabled Button").click   }  
+    
+    $ie.button(:caption, "Click Me").click
+    assert($ie.text.include?("PASS") )
+  end
+  
+  def test_Button_Exists
+    assert($ie.button(:caption, "Click Me").exists?)   
+    assert($ie.button(:caption, "Submit").exists?)   
+    assert($ie.button(:name, "b1").exists?)   
+    assert($ie.button(:id, "b2").exists?)   
+    assert($ie.button(:caption, /sub/i).exists?)   
+    
+    assert(!$ie.button(:caption, "missingcaption").exists?)   
+    assert(!$ie.button(:name, "missingname").exists?)   
+    assert(!$ie.button(:id, "missingid").exists?)   
+    assert(!$ie.button(:caption, /missing/i).exists?)   
+  end
+  
+  def test_Button_Enabled
+    assert($ie.button(:caption, "Click Me").enabled?)   
+    assert(!$ie.button(:caption, "Disabled Button").enabled?)   
+    assert(!$ie.button(:name, "b4").enabled?)   
+    assert(!$ie.button(:id, "b5").enabled?)   
+    
+    assert_raises(UnknownObjectException , "UnknownObjectException was supposed to be thrown" ) {   $ie.button(:name, "noName").enabled?  }  
+  end
+  
+  def test_frame
+    goto_frames_page
     
+    assert($ie.frame("buttonFrame").button(:caption, "Click Me").enabled?)   
+    assert_raises(  UnknownObjectException , "UnknownObjectException was supposed to be thrown ( no frame name supplied) " ) { $ie.button(:caption, "Disabled Button").enabled?}  
+  end
+  
 end