watir 6.10.0 → 6.10.1

data/lib/watir/alert.rb

@@ -1,120 +1,120 @@
-module Watir
-  class Alert
-    include EventuallyPresent
-    include Waitable
-
-    def initialize(browser)
-      @browser = browser
-      @alert = nil
-    end
-
-    #
-    # Returns text of alert.
-    #
-    # @example
-    #   browser.alert.text
-    #   #=> "ok"
-    #
-    # @return [String]
-    #
-
-    def text
-      wait_for_exists
-      @alert.text
-    end
-
-    #
-    # Closes alert or accepts prompts/confirms.
-    #
-    # @example
-    #   browser.alert.ok
-    #   browser.alert.exists?
-    #   #=> false
-    #
-
-    def ok
-      wait_for_exists
-      @alert.accept
-      @browser.after_hooks.run
-    end
-
-    #
-    # Closes alert or cancels prompts/confirms.
-    #
-    # @example
-    #   browser.alert.close
-    #   browser.alert.exists?
-    #   #=> false
-    #
-
-    def close
-      wait_for_exists
-      @alert.dismiss
-      @browser.after_hooks.run
-    end
-
-    #
-    # Enters text to prompt.
-    #
-    # @example
-    #   browser.alert.set "Text for prompt"
-    #   browser.alert.ok
-    #
-    # @param [String] value
-    #
-
-    def set(value)
-      wait_for_exists
-      @alert.send_keys(value)
-    end
-
-    #
-    # Returns true if alert, confirm or prompt is present and false otherwise.
-    #
-    # @example
-    #   browser.alert.exists?
-    #   #=> true
-    #
-
-    def exists?
-      assert_exists
-      true
-    rescue Exception::UnknownObjectException
-      false
-    end
-    alias_method :present?, :exists?
-
-    #
-    # @api private
-    #
-
-    def selector_string
-      'alert'
-    end
-
-    private
-
-    def assert_exists
-      @alert = @browser.driver.switch_to.alert
-    rescue Selenium::WebDriver::Error::NoAlertPresentError, Selenium::WebDriver::Error::NoSuchAlertError
-      raise Exception::UnknownObjectException, 'unable to locate alert'
-    end
-
-    def wait_for_exists
-      return assert_exists unless Watir.relaxed_locate?
-
-      begin
-        wait_until(message: "waiting for alert", &:exists?)
-      rescue Wait::TimeoutError
-        unless Watir.default_timeout == 0
-          message = "This code has slept for the duration of the default timeout "
-          message << "waiting for an Alert to exist. If the test is still passing, "
-          message << "consider using Alert#exists? instead of rescuing UnknownObjectException"
-          Watir.logger.warn message
-        end
-        raise Exception::UnknownObjectException, 'unable to locate alert'
-      end
-    end
-
-  end # Alert
-end # Watir
+module Watir
+  class Alert
+    include EventuallyPresent
+    include Waitable
+
+    def initialize(browser)
+      @browser = browser
+      @alert = nil
+    end
+
+    #
+    # Returns text of alert.
+    #
+    # @example
+    #   browser.alert.text
+    #   #=> "ok"
+    #
+    # @return [String]
+    #
+
+    def text
+      wait_for_exists
+      @alert.text
+    end
+
+    #
+    # Closes alert or accepts prompts/confirms.
+    #
+    # @example
+    #   browser.alert.ok
+    #   browser.alert.exists?
+    #   #=> false
+    #
+
+    def ok
+      wait_for_exists
+      @alert.accept
+      @browser.after_hooks.run
+    end
+
+    #
+    # Closes alert or cancels prompts/confirms.
+    #
+    # @example
+    #   browser.alert.close
+    #   browser.alert.exists?
+    #   #=> false
+    #
+
+    def close
+      wait_for_exists
+      @alert.dismiss
+      @browser.after_hooks.run
+    end
+
+    #
+    # Enters text to prompt.
+    #
+    # @example
+    #   browser.alert.set "Text for prompt"
+    #   browser.alert.ok
+    #
+    # @param [String] value
+    #
+
+    def set(value)
+      wait_for_exists
+      @alert.send_keys(value)
+    end
+
+    #
+    # Returns true if alert, confirm or prompt is present and false otherwise.
+    #
+    # @example
+    #   browser.alert.exists?
+    #   #=> true
+    #
+
+    def exists?
+      assert_exists
+      true
+    rescue Exception::UnknownObjectException
+      false
+    end
+    alias_method :present?, :exists?
+
+    #
+    # @api private
+    #
+
+    def selector_string
+      'alert'
+    end
+
+    private
+
+    def assert_exists
+      @alert = @browser.driver.switch_to.alert
+    rescue Selenium::WebDriver::Error::NoAlertPresentError, Selenium::WebDriver::Error::NoSuchAlertError
+      raise Exception::UnknownObjectException, 'unable to locate alert'
+    end
+
+    def wait_for_exists
+      return assert_exists unless Watir.relaxed_locate?
+
+      begin
+        wait_until(message: "waiting for alert", &:exists?)
+      rescue Wait::TimeoutError
+        unless Watir.default_timeout == 0
+          message = "This code has slept for the duration of the default timeout "
+          message << "waiting for an Alert to exist. If the test is still passing, "
+          message << "consider using Alert#exists? instead of rescuing UnknownObjectException"
+          Watir.logger.warn message
+        end
+        raise Exception::UnknownObjectException, 'unable to locate alert'
+      end
+    end
+
+  end # Alert
+end # Watir

data/lib/watir/aliases.rb

@@ -1,6 +1,6 @@
-module Watir
-  module Container
-    alias_method :field_set, :fieldset
-    alias_method :field_sets, :fieldsets
-  end # Container
-end # Watir
+module Watir
+  module Container
+    alias_method :field_set, :fieldset
+    alias_method :field_sets, :fieldsets
+  end # Container
+end # Watir

data/lib/watir/attribute_helper.rb

@@ -1,96 +1,96 @@
-module Watir
-
-  #
-  # @private
-  #
-  # Extended by Element, provides methods for defining attributes on the element classes.
-  #
-
-  module AttributeHelper
-
-    def inherit_attributes_from(kls)
-      kls.typed_attributes.each do |type, attrs|
-        attrs.each { |method, attr| attribute type, method, attr }
-      end
-    end
-
-    def typed_attributes
-      @typed_attributes ||= Hash.new { |hash, type| hash[type] = []  }
-    end
-
-    def attribute_list
-      @attribute_list ||= (
-        list = typed_attributes.values.flatten
-        list += ancestors[1..-1].map do |e|
-          e.attribute_list if e.respond_to?(:attribute_list)
-        end.compact.flatten
-      ).uniq
-    end
-
-    alias_method :attributes, :attribute_list
-
-    #
-    # YARD macro to generated friendly
-    # documentation for attributes.
-    #
-    # @macro [attach] attribute
-    #  @method $2
-    #  @return [$1] value of $3 property
-    #
-    def attribute(type, method, attr)
-      typed_attributes[type] << [method, attr]
-      define_attribute(type, method, attr)
-    end
-
-    private
-
-    def self.extended(klass)
-      klass.class_eval do
-        # undefine deprecated methods to use them for Element attributes
-        [:id, :type].each { |m| undef_method m if method_defined? m }
-      end
-    end
-
-    def define_attribute(type, name, attr)
-      case type.to_s
-      when 'String'
-        define_string_attribute(name, attr)
-      when 'Boolean'
-        define_boolean_attribute(name, attr)
-      when 'Integer'
-        define_int_attribute(name, attr)
-      when 'Float'
-        define_float_attribute(name, attr)
-      else
-        Watir.logger.debug "treating #{type.inspect} as string for now"
-      end
-    end
-
-    def define_string_attribute(mname, aname)
-      define_method mname do
-        attribute_value(aname).to_s
-      end
-    end
-
-    def define_boolean_attribute(mname, aname)
-      define_method mname do
-        attribute_value(aname) == "true"
-      end
-    end
-
-    def define_int_attribute(mname, aname)
-      define_method mname do
-        value = attribute_value(aname)
-        value && Integer(value)
-      end
-    end
-
-    def define_float_attribute(mname, aname)
-      define_method mname do
-        value = attribute_value(aname)
-        value && Float(value)
-      end
-    end
-
-  end # AttributeHelper
-end # Watir
+module Watir
+
+  #
+  # @private
+  #
+  # Extended by Element, provides methods for defining attributes on the element classes.
+  #
+
+  module AttributeHelper
+
+    def inherit_attributes_from(kls)
+      kls.typed_attributes.each do |type, attrs|
+        attrs.each { |method, attr| attribute type, method, attr }
+      end
+    end
+
+    def typed_attributes
+      @typed_attributes ||= Hash.new { |hash, type| hash[type] = []  }
+    end
+
+    def attribute_list
+      @attribute_list ||= (
+        list = typed_attributes.values.flatten
+        list += ancestors[1..-1].map do |e|
+          e.attribute_list if e.respond_to?(:attribute_list)
+        end.compact.flatten
+      ).uniq
+    end
+
+    alias_method :attributes, :attribute_list
+
+    #
+    # YARD macro to generated friendly
+    # documentation for attributes.
+    #
+    # @macro [attach] attribute
+    #  @method $2
+    #  @return [$1] value of $3 property
+    #
+    def attribute(type, method, attr)
+      typed_attributes[type] << [method, attr]
+      define_attribute(type, method, attr)
+    end
+
+    private
+
+    def self.extended(klass)
+      klass.class_eval do
+        # undefine deprecated methods to use them for Element attributes
+        [:id, :type].each { |m| undef_method m if method_defined? m }
+      end
+    end
+
+    def define_attribute(type, name, attr)
+      case type.to_s
+      when 'String'
+        define_string_attribute(name, attr)
+      when 'Boolean'
+        define_boolean_attribute(name, attr)
+      when 'Integer'
+        define_int_attribute(name, attr)
+      when 'Float'
+        define_float_attribute(name, attr)
+      else
+        Watir.logger.debug "treating #{type.inspect} as string for now"
+      end
+    end
+
+    def define_string_attribute(mname, aname)
+      define_method mname do
+        attribute_value(aname).to_s
+      end
+    end
+
+    def define_boolean_attribute(mname, aname)
+      define_method mname do
+        attribute_value(aname) == "true"
+      end
+    end
+
+    def define_int_attribute(mname, aname)
+      define_method mname do
+        value = attribute_value(aname)
+        value && Integer(value)
+      end
+    end
+
+    def define_float_attribute(mname, aname)
+      define_method mname do
+        value = attribute_value(aname)
+        value && Float(value)
+      end
+    end
+
+  end # AttributeHelper
+end # Watir

data/lib/watir/browser.rb

@@ -1,349 +1,349 @@
-module Watir
-
-  #
-  # The main class through which you control the browser.
-  #
-
-  class Browser
-    include Container
-    include HasWindow
-    include Waitable
-
-    attr_writer :default_context, :original_window
-    attr_reader :driver
-    attr_reader :after_hooks
-    alias_method :wd, :driver # ensures duck typing with Watir::Element
-
-    class << self
-      #
-      # Creates a Watir::Browser instance and goes to URL.
-      #
-      # @example
-      #   browser = Watir::Browser.start "www.google.com", :chrome
-      #   #=> #<Watir::Browser:0x..fa45a499cb41e1752 url="http://www.google.com" title="Google">
-      #
-      # @param [String] url
-      # @param [Symbol, Selenium::WebDriver] browser :firefox, :ie, :chrome, :remote or Selenium::WebDriver instance
-      # @return [Watir::Browser]
-      #
-      def start(url, browser = :chrome, *args)
-        b = new(browser, *args)
-        b.goto url
-
-        b
-      end
-    end
-
-    #
-    # Creates a Watir::Browser instance.
-    #
-    # @param [Symbol, Selenium::WebDriver] browser :firefox, :ie, :chrome, :remote or Selenium::WebDriver instance
-    # @param args Passed to the underlying driver
-    #
-
-    def initialize(browser = :chrome, *args)
-      case browser
-      when ::Symbol, String
-        selenium_args = Watir::Capabilities.new(browser, *args).to_args
-        @driver = Selenium::WebDriver.for *selenium_args
-      when Selenium::WebDriver::Driver
-        @driver = browser
-      else
-        raise ArgumentError, "expected Symbol or Selenium::WebDriver::Driver, got #{browser.class}"
-      end
-
-      @after_hooks = AfterHooks.new(self)
-      @closed = false
-      @default_context = true
-    end
-
-    def inspect
-      '#<%s:0x%x url=%s title=%s>' % [self.class, hash*2, url.inspect, title.inspect]
-    rescue Errno::ECONNREFUSED
-      '#<%s:0x%x closed=true>' % [self.class, hash*2]
-    rescue Selenium::WebDriver::Error::UnhandledAlertError, Selenium::WebDriver::Error::UnexpectedAlertOpenError
-      '#<%s:0x%x alert=true>' % [self.class, hash*2]
-    end
-    alias selector_string inspect
-
-    #
-    # Goes to the given URL.
-    #
-    # @example
-    #   browser.goto "watir.github.io"
-    #
-    # @param [String] uri The url.
-    # @return [String] The url you end up at.
-    #
-
-    def goto(uri)
-      uri = "http://#{uri}" unless uri =~ URI.regexp
-
-      @driver.navigate.to uri
-      @after_hooks.run
-
-      uri
-    end
-
-    #
-    # Navigates back in history.
-    #
-
-    def back
-      @driver.navigate.back
-      @after_hooks.run
-    end
-
-    #
-    # Navigates forward in history.
-    #
-
-    def forward
-      @driver.navigate.forward
-      @after_hooks.run
-    end
-
-    #
-    # Returns URL of current page.
-    #
-    # @example
-    #   browser.goto "watir.com"
-    #   browser.url
-    #   #=> "http://watir.com/"
-    #
-    # @return [String]
-    #
-
-    def url
-      assert_exists
-      @driver.current_url
-    end
-
-    #
-    # Returns title of current page.
-    #
-    # @example
-    #   browser.goto "watir.github.io"
-    #   browser.title
-    #   #=> "Watir is... – Watir Project – Watir stands for Web Application Testing In Ruby. It facilitates the writing of automated tests by mimicking the behavior of a user interacting with a website."
-    #
-    # @return [String]
-    #
-
-    def title
-      @driver.title
-    end
-
-    #
-    # Closes browser.
-    #
-
-    def close
-      return if @closed
-      @driver.quit
-      @closed = true
-    end
-    alias_method :quit, :close # TODO: close vs quit
-
-    #
-    # Handles cookies.
-    #
-    # @return [Watir::Cookies]
-    #
-
-    def cookies
-      @cookies ||= Cookies.new driver.manage
-    end
-
-    #
-    # Returns browser name.
-    #
-    # @example
-    #   browser = Watir::Browser.new :chrome
-    #   browser.name
-    #   #=> :chrome
-    #
-    # @return [Symbol]
-    #
-
-    def name
-      @driver.browser
-    end
-
-    #
-    # Returns text of page body.
-    #
-    # @return [String]
-    #
-
-    def text
-      body.text
-    end
-
-    #
-    # Returns HTML code of current page.
-    #
-    # @return [String]
-    #
-
-    def html
-      # use body.html instead?
-      @driver.page_source
-    end
-
-    #
-    # Handles JavaScript alerts, confirms and prompts.
-    #
-    # @return [Watir::Alert]
-    #
-
-    def alert
-      Alert.new(self)
-    end
-
-    #
-    # Refreshes current page.
-    #
-
-    def refresh
-      @driver.navigate.refresh
-      @after_hooks.run
-    end
-
-    #
-    # Waits until readyState of document is complete.
-    #
-    # @example
-    #   browser.wait
-    #
-    # @param [Integer] timeout
-    # @raise [Watir::Wait::TimeoutError] if timeout is exceeded
-    #
-
-    def wait(timeout = 5)
-      wait_until(timeout: timeout, message: "waiting for document.readyState == 'complete'") do
-        ready_state == "complete"
-      end
-    end
-
-    #
-    # Returns readyState of document.
-    #
-    # @return [String]
-    #
-
-    def ready_state
-      execute_script 'return document.readyState'
-    end
-
-    #
-    # Returns the text of status bar.
-    #
-    # @return [String]
-    #
-
-    def status
-      execute_script "return window.status;"
-    end
-
-    #
-    # Executes JavaScript snippet.
-    #
-    # If you are going to use the value snippet returns, make sure to use
-    # `return` explicitly.
-    #
-    # @example Check that Ajax requests are completed with jQuery
-    #   browser.execute_script("return jQuery.active") == 0
-    #   #=> true
-    #
-    # @param [String] script JavaScript snippet to execute
-    # @param args Arguments will be available in the given script in the 'arguments' pseudo-array
-    #
-
-    def execute_script(script, *args)
-      args.map! { |e| e.kind_of?(Watir::Element) ? e.wd : e }
-      returned = @driver.execute_script(script, *args)
-
-      wrap_elements_in(self, returned)
-    end
-
-    #
-    # Sends sequence of keystrokes to currently active element.
-    #
-    # @example
-    #   browser.goto "www.google.com"
-    #   browser.send_keys "Watir", :return
-    #
-    # @param [String, Symbol] args
-    #
-
-    def send_keys(*args)
-      @driver.switch_to.active_element.send_keys(*args)
-    end
-
-    #
-    # Handles screenshots of current pages.
-    #
-    # @return [Watir::Screenshot]
-    #
-
-    def screenshot
-      Screenshot.new driver
-    end
-
-    #
-    # Returns true if browser is not closed and false otherwise.
-    #
-    # @return [Boolean]
-    #
-
-    def exist?
-      !@closed && window.present?
-    end
-    alias_method :exists?, :exist?
-
-    #
-    # Protocol shared with Watir::Element
-    #
-    # @api private
-    #
-
-    def assert_exists
-      ensure_context
-      return if window.present?
-      raise Exception::NoMatchingWindowFoundException, "browser window was closed"
-    end
-
-    def ensure_context
-      raise Exception::Error, "browser was closed" if @closed
-      driver.switch_to.default_content unless @default_context
-      @default_context = true
-    end
-
-    def browser
-      self
-    end
-
-    private
-
-    def wrap_elements_in(scope, obj)
-      case obj
-      when Selenium::WebDriver::Element
-        wrap_element(scope, obj)
-      when Array
-        obj.map { |e| wrap_elements_in(scope, e) }
-      when Hash
-        obj.each { |k,v| obj[k] = wrap_elements_in(scope, v) }
-
-        obj
-      else
-        obj
-      end
-    end
-
-    def wrap_element(scope, element)
-      Watir.element_class_for(element.tag_name.downcase).new(scope, element: element)
-    end
-
-  end # Browser
-end # Watir
+module Watir
+
+  #
+  # The main class through which you control the browser.
+  #
+
+  class Browser
+    include Container
+    include HasWindow
+    include Waitable
+
+    attr_writer :default_context, :original_window
+    attr_reader :driver
+    attr_reader :after_hooks
+    alias_method :wd, :driver # ensures duck typing with Watir::Element
+
+    class << self
+      #
+      # Creates a Watir::Browser instance and goes to URL.
+      #
+      # @example
+      #   browser = Watir::Browser.start "www.google.com", :chrome
+      #   #=> #<Watir::Browser:0x..fa45a499cb41e1752 url="http://www.google.com" title="Google">
+      #
+      # @param [String] url
+      # @param [Symbol, Selenium::WebDriver] browser :firefox, :ie, :chrome, :remote or Selenium::WebDriver instance
+      # @return [Watir::Browser]
+      #
+      def start(url, browser = :chrome, *args)
+        b = new(browser, *args)
+        b.goto url
+
+        b
+      end
+    end
+
+    #
+    # Creates a Watir::Browser instance.
+    #
+    # @param [Symbol, Selenium::WebDriver] browser :firefox, :ie, :chrome, :remote or Selenium::WebDriver instance
+    # @param args Passed to the underlying driver
+    #
+
+    def initialize(browser = :chrome, *args)
+      case browser
+      when ::Symbol, String
+        selenium_args = Watir::Capabilities.new(browser, *args).to_args
+        @driver = Selenium::WebDriver.for *selenium_args
+      when Selenium::WebDriver::Driver
+        @driver = browser
+      else
+        raise ArgumentError, "expected Symbol or Selenium::WebDriver::Driver, got #{browser.class}"
+      end
+
+      @after_hooks = AfterHooks.new(self)
+      @closed = false
+      @default_context = true
+    end
+
+    def inspect
+      '#<%s:0x%x url=%s title=%s>' % [self.class, hash*2, url.inspect, title.inspect]
+    rescue Errno::ECONNREFUSED
+      '#<%s:0x%x closed=true>' % [self.class, hash*2]
+    rescue Selenium::WebDriver::Error::UnhandledAlertError, Selenium::WebDriver::Error::UnexpectedAlertOpenError
+      '#<%s:0x%x alert=true>' % [self.class, hash*2]
+    end
+    alias selector_string inspect
+
+    #
+    # Goes to the given URL.
+    #
+    # @example
+    #   browser.goto "watir.github.io"
+    #
+    # @param [String] uri The url.
+    # @return [String] The url you end up at.
+    #
+
+    def goto(uri)
+      uri = "http://#{uri}" unless uri =~ URI.regexp
+
+      @driver.navigate.to uri
+      @after_hooks.run
+
+      uri
+    end
+
+    #
+    # Navigates back in history.
+    #
+
+    def back
+      @driver.navigate.back
+      @after_hooks.run
+    end
+
+    #
+    # Navigates forward in history.
+    #
+
+    def forward
+      @driver.navigate.forward
+      @after_hooks.run
+    end
+
+    #
+    # Returns URL of current page.
+    #
+    # @example
+    #   browser.goto "watir.com"
+    #   browser.url
+    #   #=> "http://watir.com/"
+    #
+    # @return [String]
+    #
+
+    def url
+      assert_exists
+      @driver.current_url
+    end
+
+    #
+    # Returns title of current page.
+    #
+    # @example
+    #   browser.goto "watir.github.io"
+    #   browser.title
+    #   #=> "Watir is... – Watir Project – Watir stands for Web Application Testing In Ruby. It facilitates the writing of automated tests by mimicking the behavior of a user interacting with a website."
+    #
+    # @return [String]
+    #
+
+    def title
+      @driver.title
+    end
+
+    #
+    # Closes browser.
+    #
+
+    def close
+      return if @closed
+      @driver.quit
+      @closed = true
+    end
+    alias_method :quit, :close # TODO: close vs quit
+
+    #
+    # Handles cookies.
+    #
+    # @return [Watir::Cookies]
+    #
+
+    def cookies
+      @cookies ||= Cookies.new driver.manage
+    end
+
+    #
+    # Returns browser name.
+    #
+    # @example
+    #   browser = Watir::Browser.new :chrome
+    #   browser.name
+    #   #=> :chrome
+    #
+    # @return [Symbol]
+    #
+
+    def name
+      @driver.browser
+    end
+
+    #
+    # Returns text of page body.
+    #
+    # @return [String]
+    #
+
+    def text
+      body.text
+    end
+
+    #
+    # Returns HTML code of current page.
+    #
+    # @return [String]
+    #
+
+    def html
+      # use body.html instead?
+      @driver.page_source
+    end
+
+    #
+    # Handles JavaScript alerts, confirms and prompts.
+    #
+    # @return [Watir::Alert]
+    #
+
+    def alert
+      Alert.new(self)
+    end
+
+    #
+    # Refreshes current page.
+    #
+
+    def refresh
+      @driver.navigate.refresh
+      @after_hooks.run
+    end
+
+    #
+    # Waits until readyState of document is complete.
+    #
+    # @example
+    #   browser.wait
+    #
+    # @param [Integer] timeout
+    # @raise [Watir::Wait::TimeoutError] if timeout is exceeded
+    #
+
+    def wait(timeout = 5)
+      wait_until(timeout: timeout, message: "waiting for document.readyState == 'complete'") do
+        ready_state == "complete"
+      end
+    end
+
+    #
+    # Returns readyState of document.
+    #
+    # @return [String]
+    #
+
+    def ready_state
+      execute_script 'return document.readyState'
+    end
+
+    #
+    # Returns the text of status bar.
+    #
+    # @return [String]
+    #
+
+    def status
+      execute_script "return window.status;"
+    end
+
+    #
+    # Executes JavaScript snippet.
+    #
+    # If you are going to use the value snippet returns, make sure to use
+    # `return` explicitly.
+    #
+    # @example Check that Ajax requests are completed with jQuery
+    #   browser.execute_script("return jQuery.active") == 0
+    #   #=> true
+    #
+    # @param [String] script JavaScript snippet to execute
+    # @param args Arguments will be available in the given script in the 'arguments' pseudo-array
+    #
+
+    def execute_script(script, *args)
+      args.map! { |e| e.kind_of?(Watir::Element) ? e.wd : e }
+      returned = @driver.execute_script(script, *args)
+
+      wrap_elements_in(self, returned)
+    end
+
+    #
+    # Sends sequence of keystrokes to currently active element.
+    #
+    # @example
+    #   browser.goto "www.google.com"
+    #   browser.send_keys "Watir", :return
+    #
+    # @param [String, Symbol] args
+    #
+
+    def send_keys(*args)
+      @driver.switch_to.active_element.send_keys(*args)
+    end
+
+    #
+    # Handles screenshots of current pages.
+    #
+    # @return [Watir::Screenshot]
+    #
+
+    def screenshot
+      Screenshot.new driver
+    end
+
+    #
+    # Returns true if browser is not closed and false otherwise.
+    #
+    # @return [Boolean]
+    #
+
+    def exist?
+      !@closed && window.present?
+    end
+    alias_method :exists?, :exist?
+
+    #
+    # Protocol shared with Watir::Element
+    #
+    # @api private
+    #
+
+    def assert_exists
+      ensure_context
+      return if window.present?
+      raise Exception::NoMatchingWindowFoundException, "browser window was closed"
+    end
+
+    def ensure_context
+      raise Exception::Error, "browser was closed" if @closed
+      driver.switch_to.default_content unless @default_context
+      @default_context = true
+    end
+
+    def browser
+      self
+    end
+
+    private
+
+    def wrap_elements_in(scope, obj)
+      case obj
+      when Selenium::WebDriver::Element
+        wrap_element(scope, obj)
+      when Array
+        obj.map { |e| wrap_elements_in(scope, e) }
+      when Hash
+        obj.each { |k,v| obj[k] = wrap_elements_in(scope, v) }
+
+        obj
+      else
+        obj
+      end
+    end
+
+    def wrap_element(scope, element)
+      Watir.element_class_for(element.tag_name.downcase).new(scope, element: element)
+    end
+
+  end # Browser
+end # Watir