watir-classic 3.7.0 → 4.0.0

data/lib/watir-classic/{ie-process.rb → browser_process.rb}

@@ -1,13 +1,13 @@
 require 'win32/process'
 
 module Watir
-  class IE
+  class Browser
     class Process
       def self.start
         program_files = ENV['ProgramFiles'] || "c:\\Program Files"
         startup_command = "#{program_files}\\Internet Explorer\\iexplore.exe"
-        startup_command << " -nomerge" if IE.version_parts.first.to_i == 8
-        startup_command << " -noframemerging" if IE.version_parts.first.to_i >= 9
+        startup_command << " -nomerge" if Browser.version_parts.first.to_i == 8
+        startup_command << " -noframemerging" if Browser.version_parts.first.to_i >= 9
         process_info = ::Process.create('app_name' => "#{startup_command} about:blank")
         process_id = process_info.process_id
         new process_id
@@ -22,7 +22,7 @@ module Watir
       def window
         Wait.until do
           found_window = nil
-          IE.each do | ie |
+          Browser.each do | ie |
             window = ie.ie
             hwnd = ie.hwnd
             process_id = Process.process_id_from_hwnd hwnd        

data/lib/watir-classic/cookies.rb

@@ -1,7 +1,7 @@
 require "uri"
 
 module Watir
-  # Returned by {IE#cookies}.
+  # Returned by {Browser#cookies}.
   class Cookies
     include Enumerable
 

data/lib/watir-classic/element.rb

@@ -361,7 +361,7 @@ module Watir
 
     # @private
     def dispatch_event(event)
-      if IE.version_parts.first.to_i >= 9 && container.page_container.document.documentMode.to_i >= 9
+      if Browser.version_parts.first.to_i >= 9 && container.page_container.document.documentMode.to_i >= 9
         ole_object.dispatchEvent(create_event(event))
       else
         ole_object.fireEvent(event)
@@ -454,7 +454,7 @@ module Watir
       element = "#{self.class}.new(#{@page_container.attach_command}, :tag_name => Array.new << '#{tag_name}', :unique_number => #{unique_number})"
       method = build_method(method_name, *args)
       ruby_code = "$:.unshift(#{$LOAD_PATH.map {|p| "'#{p}'" }.join(").unshift(")});" <<
-                    "require '#{File.expand_path(File.dirname(__FILE__))}/core';#{element}.#{method};"
+                    "require '#{File.expand_path(File.dirname(__FILE__))}/../watir-classic';#{element}.#{method};"
       ruby_code
     end
 

data/lib/watir-classic/frame.rb

@@ -22,7 +22,7 @@ module Watir
       if @document
         @document
       else
-        raise FrameAccessDeniedException, "IE will not allow access to this frame for security reasons. You can work around this with ie.goto(frame.src)"
+        raise FrameAccessDeniedException, "IE will not allow access to this frame for security reasons. You can work around this with browser.goto(frame.src)"
       end
     end
 

data/lib/watir-classic/ie_deprecated.rb

@@ -0,0 +1,5 @@
+module Watir
+  warn "[DEPRECATED] Using Watir::IE constant is deprecated, use Watir::Browser instead."
+  # @deprecated Use {Browser} instead.
+  IE = Browser
+end

data/lib/watir-classic/modal_dialog.rb

@@ -66,7 +66,7 @@ module Watir
 
     # @private
     def attach_command
-      "Watir::IE.find(:hwnd, #{@container.hwnd}).modal_dialog"
+      "Watir::Browser.find(:hwnd, #{@container.hwnd}).modal_dialog"
     end
 
     # @private

data/lib/watir-classic/process.rb

@@ -12,7 +12,7 @@ module Watir
     
   end
   
-  class IE
+  class Browser
     # Returns the number of IEXPLORE processes currently running.
     # @return [Fixnum] number of ie processes.
     def self.process_count

data/lib/watir-classic/screenshot.rb

@@ -3,7 +3,7 @@ require "base64"
 require "win32/screenshot"
 
 module Watir
-  # Returned by {IE#screenshot}.
+  # Returned by {Browser#screenshot}.
   class Screenshot
     def initialize(browser_hwnd)
       @hwnd = browser_hwnd

data/lib/watir-classic/window.rb

@@ -1,5 +1,5 @@
 module Watir
-  # Returned by {IE#window}.
+  # Returned by {Browser#window}.
   class Window
     include ElementExtensions
 
@@ -43,7 +43,7 @@ module Watir
     # @return [Browser] browser of the window.
     def browser
       @browser ||= begin
-                    IE.find(@locators.keys.first, @locators.values.first)
+                    Browser.find(@locators.keys.first, @locators.values.first)
                    end
     end
 
@@ -68,7 +68,7 @@ module Watir
         ensure
           @main_browser.ie = self.class.__main_ie
           # try to find some existing IE when needed
-          @main_browser.ie = IE._find(:index, 0) unless @main_browser.exists?
+          @main_browser.ie = Browser._find(:index, 0) unless @main_browser.exists?
         end
       end
       self

data/lib/watir-classic/xpath_locator.rb

@@ -29,7 +29,7 @@ module Watir
     # execute xpath selector and return an array of elements
     def elements_by_xpath(xpath)
       doc = xmlparser_document_object
-      current_tag = @container.is_a?(IE) ? "body" : @container.tag_name
+      current_tag = @container.is_a?(Browser) ? "body" : @container.tag_name
 
       doc.xpath(xpath).reduce([]) do |elements, element|
         absolute_xpath_parts = element.path.split("/")
@@ -45,7 +45,7 @@ module Watir
     end    
 
     def direct_children container, elements
-      return elements if container.is_a?(IE)
+      return elements if container.is_a?(Browser)
       elements.select {|el| el.parent == container}
     end
 

data/spec/implementation.rb

@@ -5,7 +5,7 @@ WatirSpec.implementation do |imp|
   imp.name = :watir_classic
 
   WatirSpec.persistent_browser = true
-  imp.browser_class = Watir::IE
+  imp.browser_class = Watir::Browser
   browser = :internet_explorer
   browser_version = "#{browser}#{imp.browser_class.version.to_i}".to_sym
 

data/watir-classic.gemspec

@@ -28,7 +28,6 @@ Gem::Specification.new do |s|
   s.add_dependency 'nokogiri', ">= 1.5.7.rc3"
   s.add_dependency 'ffi', '~>1.0'
   s.add_dependency 'rautomation', '~>0.7'
-  s.add_dependency 'user-choices'
   s.add_dependency 'multi_json'
   s.add_dependency 'win32screenshot'
 
@@ -37,4 +36,5 @@ Gem::Specification.new do |s|
   s.add_development_dependency("yard")
   s.add_development_dependency("sinatra")
   s.add_development_dependency("childprocess")
+  s.add_development_dependency('rake')
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: watir-classic
 version: !ruby/object:Gem::Version
-  version: 3.7.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Bret Pettichord
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-10 00:00:00.000000000 Z
+date: 2013-10-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: win32-process
@@ -80,20 +80,6 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
-- !ruby/object:Gem::Dependency
-  name: user-choices
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - '>='
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
@@ -192,6 +178,20 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |2
       WATIR is "Web Application Testing in Ruby". Watir (pronounced water) is a free,
       open-source functional testing tool for automating browser-based tests of web applications.
@@ -214,7 +214,6 @@ files:
 - CHANGES
 - CONTRIBUTORS.txt
 - Gemfile
-- Gemfile.lock
 - LICENSE
 - README.rdoc
 - Rakefile
@@ -228,10 +227,9 @@ files:
 - lib/watir-classic/IEDialog/stdafx.cpp
 - lib/watir-classic/IEDialog/stdafx.h
 - lib/watir-classic/browser.rb
-- lib/watir-classic/browsers.rb
+- lib/watir-classic/browser_process.rb
 - lib/watir-classic/container.rb
 - lib/watir-classic/cookies.rb
-- lib/watir-classic/core.rb
 - lib/watir-classic/dialogs/alert.rb
 - lib/watir-classic/dialogs/file_field.rb
 - lib/watir-classic/drag_and_drop_helper.rb
@@ -242,9 +240,7 @@ files:
 - lib/watir-classic/ext/json2.js
 - lib/watir-classic/form.rb
 - lib/watir-classic/frame.rb
-- lib/watir-classic/ie-class.rb
-- lib/watir-classic/ie-process.rb
-- lib/watir-classic/ie.rb
+- lib/watir-classic/ie_deprecated.rb
 - lib/watir-classic/image.rb
 - lib/watir-classic/input_elements.rb
 - lib/watir-classic/link.rb
@@ -253,7 +249,6 @@ files:
 - lib/watir-classic/modal_dialog.rb
 - lib/watir-classic/module.rb
 - lib/watir-classic/non_control_elements.rb
-- lib/watir-classic/options.rb
 - lib/watir-classic/page-container.rb
 - lib/watir-classic/process.rb
 - lib/watir-classic/screenshot.rb
@@ -304,7 +299,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements:
 - Microsoft Windows running Internet Explorer 5.5 or later.
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.0.7
 signing_key: 
 specification_version: 4
 summary: Automated testing tool for web applications.

data/Gemfile.lock

@@ -1,79 +0,0 @@
-PATH
-  remote: .
-  specs:
-    watir-classic (3.7.0)
-      ffi (~> 1.0)
-      multi_json
-      nokogiri (>= 1.5.7.rc3)
-      rautomation (~> 0.7)
-      user-choices
-      win32-process (>= 0.5.5)
-      win32screenshot
-      windows-pr (>= 0.6.6)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    builder (3.2.0)
-    childprocess (0.3.9)
-      ffi (~> 1.0, >= 1.0.11)
-    diff-lcs (1.2.1)
-    ffi (1.8.1-x86-mingw32)
-    hoe (3.5.1)
-      rake (>= 0.8, < 11.0)
-    mini_magick (3.5.0)
-      subexec (~> 0.2.1)
-    multi_json (1.7.2)
-    nokogiri (1.5.7.rc3-x86-mingw32)
-    rack (1.5.2)
-    rack-protection (1.4.0)
-      rack
-    rake (10.0.4)
-    rautomation (0.8.0)
-      ffi
-    rspec (2.13.0)
-      rspec-core (~> 2.13.0)
-      rspec-expectations (~> 2.13.0)
-      rspec-mocks (~> 2.13.0)
-    rspec-core (2.13.0)
-    rspec-expectations (2.13.0)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.13.0)
-    s4t-utils (1.0.4)
-      hoe (>= 1.3.0)
-    sinatra (1.3.5)
-      rack (~> 1.4)
-      rack-protection (~> 1.3)
-      tilt (~> 1.3, >= 1.3.3)
-    subexec (0.2.2)
-    syntax (1.0.0)
-    tilt (1.3.4)
-    user-choices (1.1.6.1)
-      builder (>= 2.1.2)
-      s4t-utils (>= 1.0.3)
-      xml-simple (>= 1.0.11)
-    win32-api (1.4.8-x86-mingw32)
-    win32-process (0.7.1)
-      ffi (>= 1.0.0)
-    win32screenshot (1.0.8)
-      ffi (~> 1.0)
-      mini_magick (~> 3.2)
-      rautomation (~> 0.7)
-    windows-api (0.4.2)
-      win32-api (>= 1.4.5)
-    windows-pr (1.2.2)
-      win32-api (>= 1.4.5)
-      windows-api (>= 0.3.0)
-    xml-simple (1.1.2)
-    yard (0.8.5.2)
-
-PLATFORMS
-  x86-mingw32
-
-DEPENDENCIES
-  childprocess
-  rspec (~> 2.3)
-  sinatra
-  syntax
-  watir-classic!
-  yard

data/lib/watir-classic/browsers.rb

@@ -1,7 +0,0 @@
-#--
-# watir/browsers
-# Define browsers supported by Watir
-
-Watir::Browser.support :name => 'ie', :class => 'Watir::IE', 
-  :library => 'watir-classic/ie', :gem => 'watir-classic',
-  :options => [:speed, :visible]

data/lib/watir-classic/core.rb

@@ -1,40 +0,0 @@
-# these require statements are needed for Watir
-# to work with minimum functionality
-require 'timeout'
-require 'watir-classic/win32ole'
-
-require 'watir-classic/util'
-require 'watir-classic/exceptions'
-require 'watir-classic/matches'
-require 'watir-classic/wait'
-require 'watir-classic/wait_helper'
-require 'watir-classic/element_extensions'
-
-require 'watir-classic/container'
-require 'watir-classic/xpath_locator'
-require 'watir-classic/locator'
-require 'watir-classic/page-container'
-require 'watir-classic/ie-class'
-require 'watir-classic/drag_and_drop_helper'
-require 'watir-classic/element'
-require 'watir-classic/element_collection'
-require 'watir-classic/form'
-require 'watir-classic/frame'
-require 'watir-classic/input_elements'
-require 'watir-classic/non_control_elements'
-require 'watir-classic/table'
-require 'watir-classic/image'
-require 'watir-classic/link'
-require 'watir-classic/window'
-require 'watir-classic/cookies'
-
-require 'watir-classic/win32'
-require 'watir-classic/modal_dialog'
-
-require 'watir-classic/module'
-
-require 'rautomation'
-require 'watir-classic/dialogs/file_field'
-require 'watir-classic/dialogs/alert'
-
-require 'watir-classic/supported_elements'

data/lib/watir-classic/ie-class.rb

@@ -1,664 +0,0 @@
-module Watir
-  # Main browser class.
-  class IE
-    include WaitHelper
-    include Exception
-    include Container
-    include PageContainer
-
-    class << self
-      # Maximum number of seconds to wait when attaching to a window
-      attr_writer :attach_timeout
-
-      def attach_timeout
-        @attach_timeout ||= 2
-      end
-
-      # Return the options used when creating new instances of IE.
-      # BUG: this interface invites misunderstanding/misuse such as IE.options[:speed] = :zippy]
-      def options
-        {:speed => self.speed, :visible => self.visible, :attach_timeout => self.attach_timeout}
-      end
-
-      # set values for options used when creating new instances of IE.
-      def set_options options
-        options.each do |name, value|
-          send "#{name}=", value
-        end
-      end
-
-      # The speed in which browser will type keys etc. Possible values are
-      # :slow (default), :fast and :zippy.
-      attr_writer :speed
-
-      def speed
-        @speed ||= :slow
-      end
-
-      # Set browser window to visible or hidden. Defaults to true.
-      attr_writer :visible
-
-      def visible
-        @visible ||= true
-      end
-
-      # Create a new IE window.
-      def new_window
-        ie = new true
-        ie._new_window_init
-        ie
-      end
-
-      # Create a new IE, starting at the specified url.
-      # @param [String] url url to navigate to.
-      def start(url=nil)
-        start_window url
-      end
-
-      # Create a new IE window, starting at the specified url.
-      # @param [String] url url to navigate to.
-      def start_window(url=nil)
-        ie = new_window
-        ie.goto url if url
-        ie
-      end
-
-      # Create a new IE window in a new process. 
-      # @note This method will not work when
-      #   Watir/Ruby is run under a service (instead of a user).
-      def new_process
-        ie = new true
-        ie._new_process_init
-        ie
-      end
-
-      # Create a new IE window in a new process, starting at the specified URL. 
-      # @param [String] url url to navigate to.
-      def start_process(url=nil)
-        ie = new_process
-        ie.goto url if url
-        ie
-      end
-
-      # Attach to an existing IE {Browser}.
-      #
-      # @example Attach with full title:
-      #   Watir::Browser.attach(:title, "Full title of IE")
-      #
-      # @example Attach with part of the title using {Regexp}:
-      #   Watir::Browser.attach(:title, /part of the title of IE/)
-      #
-      # @example Attach with part of the url:
-      #   Watir::Browser.attach(:url, /google/)
-      #
-      # @example Attach with window handle:
-      #   Watir::Browser.attach(:hwnd, 123456)
-      #
-      # @param [Symbol] how type of the locator. Can be :title, :url or :hwnd.
-      # @param [Symbol] what value of the locator. Can be {String}, {Regexp} or {Fixnum}
-      #   depending of the type parameter.
-      #
-      # @note This method will not work when
-      #   Watir/Ruby is run under a service (instead of a user).
-      def attach(how, what)
-        ie = new true # don't create window
-        ie._attach_init(how, what)
-        ie
-      end
-
-      # Yields successively to each IE window on the current desktop. Takes a block.
-      # @note This method will not work when
-      #   Watir/Ruby is run under a service (instead of a user).
-      # @yieldparam [IE] ie instances of IE found.
-      def each
-        shell = WIN32OLE.new('Shell.Application')
-        ie_browsers = []
-        shell.Windows.each do |window|
-          next unless (window.path =~ /Internet Explorer/ rescue false)
-          next unless (hwnd = window.hwnd rescue false)
-          ie = bind(window)
-          ie.hwnd = hwnd
-          ie_browsers << ie
-        end
-        ie_browsers.each do |ie|
-          yield ie
-        end
-      end
-
-      # @return [String] the IE browser version number as a string.
-      def version
-        @ie_version ||= begin
-                          require 'win32/registry'
-                          ::Win32::Registry::HKEY_LOCAL_MACHINE.open("SOFTWARE\\Microsoft\\Internet Explorer") do |ie_key|
-                            begin
-                              ie_key['svcVersion']
-                            rescue ::Win32::Registry::Error
-                              ie_key['Version']
-                            end
-                          end
-                        end
-      end
-
-      # @return [Array<String>] the IE browser version numbers split by "." in an Array.
-      def version_parts
-        version.split('.')
-      end
-
-      # Find existing IE window with locators.
-      # @see .attach
-      def find(how, what)
-        ie_ole = _find(how, what)
-        bind ie_ole if ie_ole
-      end
-
-      # Return an IE object that wraps the given window, typically obtained from
-      # Shell.Application.windows.
-      # @private
-      def bind(window)
-        ie = new true
-        ie.ie = window
-        ie.initialize_options
-        ie
-      end
-
-      # @private
-      def _find(how, what)
-        _find_all(how, what).first
-      end
-
-      # @private
-      def _find_all(how, what)
-        ies = []
-        count = -1
-        each do |ie|
-          window = ie.ie
-
-          case how
-          when :url
-            ies << window if (what.matches(window.locationURL))
-          when :title
-            # normal windows explorer shells do not have document
-            # note window.document will fail for "new" browsers
-            begin
-              title = window.locationname
-              title = window.document.title
-            rescue WIN32OLERuntimeError
-            end
-            ies << window if what.matches(title)
-          when :hwnd
-            begin
-              ies << window if what == window.HWND
-            rescue WIN32OLERuntimeError
-            end
-          when :index
-            count += 1
-            if count == what
-              ies << window
-              break
-            end
-          when nil
-            ies << window
-          else
-            raise ArgumentError
-          end
-        end      
-
-        ies
-      end
-
-    end
-
-    # Used internally to determine when IE has finished loading a page.
-    # @private
-    READYSTATES = {:complete => 4}
-
-    # The default color for highlighting objects as they are accessed.
-    # @private
-    HIGHLIGHT_COLOR = 'yellow'
-
-    # The time, in seconds, it took for the new page to load after executing
-    # the last command.
-    attr_reader :down_load_time
-
-    # The OLE Internet Explorer object.
-    attr_accessor :ie
-
-    # The list of unique urls that have been visited.
-    attr_reader :url_list
-
-    # @private
-    attr_writer :hwnd
-
-    # Create an IE browser instance.
-    # @param [Boolean] suppress_new_window set to true for not creating a IE
-    #   window.
-    def initialize(suppress_new_window=nil)
-      _new_window_init unless suppress_new_window
-    end
-
-    # Specifies the speed that commands will be executed at.
-    # Possible choices are:
-    # * :slow (default)
-    # * :fast 
-    # * :zippy
-    # 
-    # With :zippy, text fields will be entered at once, instead of
-    # character by character.
-    #
-    # @note :zippy speed does not trigger JavaScript events like onChange etc.
-    #
-    # @param [Symbol] how_fast possible choices are :slow (default), :fast and
-    #   :zippy
-    # @raise [ArgumentError] when invalid speed is specified.
-    def speed=(how_fast)
-      case how_fast
-      when :zippy
-        @typingspeed = 0
-        @pause_after_wait = 0.01
-        @type_keys = false
-        @speed = :fast
-      when :fast
-        @typingspeed = 0
-        @pause_after_wait = 0.01
-        @type_keys = true
-        @speed = :fast
-      when :slow
-        @typingspeed = 0.08
-        @pause_after_wait = 0.1
-        @type_keys = true
-        @speed = :slow
-      else
-        raise ArgumentError, "Invalid speed: #{how_fast}. Possible choices are :slow, :fast and :zippy."
-      end
-    end
-
-    # @return [Symbol] current speed setting. May be :slow, :fast or :zippy.
-    def speed
-      return @speed if @speed == :slow
-      return @type_keys ? :fast : :zippy
-    end
-
-    # @deprecated Use {#speed=} with :fast argument instead.
-    def set_fast_speed
-      Kernel.warn "Deprecated(IE.set_fast_speed) - use Browser#speed = :fast instead."
-      self.speed = :fast
-    end
-
-    # @deprecated Use {#speed=} with :slow argument instead.
-    def set_slow_speed
-      Kernel.warn "Deprecated(IE.set_slow_speed) - use Browser#speed = :slow instead."
-      self.speed = :slow
-    end
-
-    # @return [Boolean] true when window is visible, false otherwise.
-    def visible
-      @ie.visible
-    end
-    
-    # Set the visibility of IE window.
-    # @param [Boolean] boolean set to true if IE window should be visible, false
-    #   otherwise.
-    def visible=(boolean)
-      @ie.visible = boolean if boolean != @ie.visible
-    end
-
-    # @return [Fixnum] current IE window handle.
-    # @raise [RuntimeError] when not attached to a browser.
-    def hwnd
-      raise "Not attached to a browser" if @ie.nil?
-      @hwnd ||= @ie.hwnd
-    end
-
-    # @return [Symbol] the name of the browser. Is always :internet_explorer.
-    def name
-      :internet_explorer
-    end
-
-    # @return [Boolean] true when IE is window exists, false otherwise.
-    def exists?
-      !!(@ie.name =~ /Internet Explorer/)
-    rescue WIN32OLERuntimeError, NoMethodError
-      false
-    end
-
-    alias :exist? :exists?
-
-    # @return [String] the title of the document.
-    def title
-      @ie.document.title
-    end
-
-    # @return [String] the status text of the window, typically from the status bar at the bottom.
-    #   Will be empty if there's no status or when there are problems accessing status text.
-    def status
-      @ie.statusText
-    rescue WIN32OLERuntimeError
-      ""
-    end
-
-    #
-    # Navigation
-    #
-
-    # Navigate to the specified URL.
-    # @param [String] url url to navigate to.
-    # @return [Fixnum] time in seconds the page took to load.
-    def goto(url)
-      url = "http://" + url unless url =~ %r{://} || url == "about:blank"
-      @ie.navigate(url)
-      wait
-      return @down_load_time
-    end
-
-    # Go to the previous page - the same as clicking the browsers back button.
-    # @raise [WIN32OLERuntimeError] when the browser can't go back.
-    def back
-      @ie.GoBack
-      wait
-    end
-
-    # Go to the next page - the same as clicking the browsers forward button.
-    # @raise [WIN32OLERuntimeError] when the browser can't go forward.
-    def forward
-      @ie.GoForward
-      wait
-    end
-
-    # Refresh the current page - the same as clicking the browsers refresh button.
-    # @raise [WIN32OLERuntimeError] when the browser can't refresh.
-    def refresh
-      @ie.refresh2(3)
-      wait
-    end
-
-    def inspect
-      '#<%s:0x%x url=%s title=%s>' % [self.class, hash*2, url.inspect, title.inspect]
-    end
-
-    # Clear the list of urls that have been visited.
-    def clear_url_list
-      @url_list.clear
-    end
-
-    # Close the {Browser}.
-    def close
-      return unless exists?
-      @ie.stop
-      wait rescue nil
-      chwnd = @ie.hwnd.to_i
-      @ie.quit
-      t = ::Time.now
-      while exists?
-        # just in case to avoid possible endless loop if failing to close some
-        # window or tab
-        break if ::Time.now - t > 10
-        sleep 0.3
-      end
-    end
-
-    # Maximize the window (expands to fill the screen).
-    def maximize
-      rautomation.maximize
-    end
-
-    # Minimize the window (appears as icon on taskbar).
-    def minimize
-      rautomation.minimize
-    end
-
-    # @return [Boolean] true when window is minimized, false otherwise.
-    def minimized?
-      rautomation.minimized?
-    end
-
-    # Restore the window (after minimizing or maximizing).
-    def restore
-      rautomation.restore
-    end
-
-    # Make the window come to the front.
-    def activate
-      rautomation.activate
-    end
-
-    alias :bring_to_front :activate
-
-    # @return [Boolean] true when window is in front e.g. in focus, false otherwise.
-    def active?
-      rautomation.active?
-    end
-
-    alias :front? :active?
-
-    # @return [RAutomation::Window] the RAutomation instance for this IE window.
-    # @see https://github.com/jarmo/rautomation
-    def rautomation
-      @rautomation ||= ::RAutomation::Window.new(:hwnd => hwnd)
-    end
-
-    # @deprecated use {#rautomation} instead.
-    def autoit
-      Kernel.warn "Deprecated(IE#autoit) - use IE#rautomation instead. Refer to https://github.com/jarmo/RAutomation for updating your scripts."
-      @autoit ||= ::RAutomation::Window.new(:hwnd => hwnd, :adapter => :autoit)
-    end
-
-    # Activates the window and sends keys to it.
-    #
-    # @example
-    #   browser.send_keys("Hello World", :enter)
-    #
-    # @see https://github.com/jarmo/RAutomation/blob/master/lib/rautomation/adapter/win_32/window.rb RAutomation::Window#send_keys documentation.
-    def send_keys(*keys)
-      rautomation.send_keys *keys
-    end
-
-    #
-    # Document and Document Data
-    #
-
-    # @return [WIN32OLE] current IE document.
-    def document
-      @ie.document
-    end
-
-    # @return [String] current url, as displayed in the address bar of the browser.
-    def url
-      @ie.LocationURL
-    end
-
-    # Create a {Screenshot} instance.
-    def screenshot
-      Screenshot.new(hwnd)
-    end
-
-    # Retrieve a {Window} instance.
-    # 
-    # @example Retrieve a different window without block.
-    #   browser.window(:title => /other window title/).use
-    #   browser.title # => "other window title"
-    #
-    # @example Use different window with block.
-    #   browser.window(:title => /other window title/) do
-    #     browser.title # => "other window title"
-    #   end
-    #   browser.title # => "current window title"
-    #
-    # @param [Hash] specifiers options for finding window.
-    # @option specifiers [String,Regexp] :title Title of the window.
-    # @option specifiers [String,Regexp] :url Url of the window.
-    # @option specifiers [Fixnum] :index The index of the window.
-    # @yield yield optionally to the found window.
-    # @return [Window] found window instance.
-    def window(specifiers={}, &blk)
-      win = Window.new(self, specifiers, &blk)
-      win.use &blk if blk
-      win
-    end
-
-    # @see #window
-    # @return [Array<Window>] array of found windows.
-    def windows(specifiers={})
-      self.class._find_all(specifiers.keys.first, specifiers.values.first).map {|ie| Window.new(self, specifiers, IE.bind(ie))}
-    end
-
-    # Retrieve {Cookies} instance.
-    def cookies
-      Cookies.new(self)
-    end
-
-    # Add an error checker that gets executed after every page load, click etc.
-    #
-    # @example
-    #   browser.add_checker lambda { |browser| raise "Error!" if browser.text.include? "Error" }
-    #
-    # @param [Proc] checker Proc object which gets yielded with {IE} instance.
-    def add_checker(checker)
-      @error_checkers << checker
-    end
-
-    # Disable an error checker added via {#add_checker}.
-    #
-    # @param [Proc] checker Proc object to be removed from error checkers.
-    def disable_checker(checker)
-      @error_checkers.delete(checker)
-    end
-
-    # Gives focus to the window frame.
-    def focus
-      active_element = document.activeElement
-      active_element.blur if active_element && active_element.tagName != "BODY"
-      document.focus
-    end
-
-    # @private
-    def attach_command
-      "Watir::IE.attach(:hwnd, #{hwnd})"
-    end
-
-    # @private
-    def _new_window_init
-      create_browser_window
-      initialize_options
-      goto 'about:blank' # this avoids numerous problems caused by lack of a document
-    end
-
-    # @private
-    def _new_process_init
-      iep = Process.start
-      @ie = iep.window
-      @process_id = iep.process_id
-      initialize_options
-      goto 'about:blank'
-    end
-
-    # this method is used internally to attach to an existing window
-    # @private
-    def _attach_init how, what
-      attach_browser_window how, what
-      initialize_options
-      wait
-    end
-
-    # @private
-    def initialize_options
-      self.visible = IE.visible
-      self.speed = IE.speed
-
-      @ole_object = nil
-      @page_container = self
-      @error_checkers = []
-      @active_object_highlight_color = HIGHLIGHT_COLOR
-      @url_list = []
-    end
-
-    #
-    # Synchronization
-    #
-
-    # Block execution until the page has loaded.
-    #
-    # Will raise Timeout::Error if page hasn't been loaded within 5 minutes.
-    # Note: This code needs to be prepared for the ie object to be closed at 
-    # any moment!
-    #
-    # @private
-    def wait(no_sleep=false)
-      @xml_parser_doc = nil
-      @down_load_time = 0.0
-      interval = 0.05
-      start_load_time = ::Time.now
-
-      Timeout::timeout(5*60) do
-        begin
-          while @ie.busy
-            sleep interval
-          end
-
-          until READYSTATES.has_value?(@ie.readyState)
-            sleep interval
-          end
-
-          until @ie.document
-            sleep interval
-          end
-
-          documents_to_wait_for = [@ie.document]
-        rescue WIN32OLERuntimeError # IE window must have been closed
-          @down_load_time = ::Time.now - start_load_time
-          return @down_load_time
-        end
-
-        while doc = documents_to_wait_for.shift
-          begin
-            until READYSTATES.has_key?(doc.readyState.to_sym)
-              sleep interval
-            end
-            @url_list << doc.location.href unless @url_list.include?(doc.location.href)
-            doc.frames.length.times do |n|
-              begin
-                documents_to_wait_for << doc.frames[n.to_s].document
-              rescue WIN32OLERuntimeError, NoMethodError
-              end
-            end
-          rescue WIN32OLERuntimeError
-          end
-        end
-      end
-
-      @down_load_time = ::Time.now - start_load_time
-      run_error_checks
-      sleep @pause_after_wait unless no_sleep
-      @down_load_time
-    end
-
-    # Error checkers
-
-    # Run the predefined error checks.
-    #
-    # @private
-    def run_error_checks
-      @error_checkers.each { |e| e.call(self) }
-    end
-
-    private
-
-    def create_browser_window
-      @ie = WIN32OLE.new('InternetExplorer.Application')
-    end
-
-    def attach_browser_window how, what
-      ieTemp = nil
-      begin
-        Wait.until(IE.attach_timeout) do
-          ieTemp = IE._find how, what
-        end
-      rescue Wait::TimeoutError
-        raise NoMatchingWindowFoundException,
-        "Unable to locate a window with #{how} of #{what}"
-      end
-      @ie = ieTemp
-    end
-
-
-  end # class IE
-end