celerity 0.0.3 → 0.0.4

data/History.txt

@@ -1,3 +1,17 @@
+== 0.0.4 2008-08-18
+* Minor enhancements
+  * Update HtmlUnit to 2.2
+  * New methods: Element#focus, Element#parent, Table#child_row, Table#child_cell, TableRow#child_cell
+  * Rename Celerity::IE -> Celerity::Browser (but Celerity::IE still points to the class)
+  * Add Celerity::Browser.new(:browser => :firefox) to use HtmlUnit's Firefox mode.
+  * Make it easier to run the spec suite against other implementations.
+  * Bugfixes:
+    - Image#click
+    - Finding elements by id could give weird errors if multiple elements had the same id.
+    - If getElementById returns an element with the wrong tag name, output a warning and find the correct element by iteration instead.
+    - Browser#goto regexp
+    - Frames (collection) support
+
 == 0.0.3 2008-05-26
 * 3 major enhancements:
   * Added support for <ul>, <ol>, <thead>, <tfoot>, <h1>, <h2>, <h3>, <h4>, <h5> and <h6> elements

data/Manifest.txt

@@ -1,174 +1,150 @@
 History.txt
-spec/table_bodies_spec.rb
-spec/table_spec.rb
-spec/checkbox_spec.rb
-spec/buttons_spec.rb
-spec/table_headers_spec.rb
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/celerity.rb
+lib/celerity/browser.rb
+lib/celerity/clickable_element.rb
+lib/celerity/collections.rb
+lib/celerity/container.rb
+lib/celerity/disabled_element.rb
+lib/celerity/element.rb
+lib/celerity/element_collections.rb
+lib/celerity/element_locator.rb
+lib/celerity/element_map.rb
+lib/celerity/elements/button.rb
+lib/celerity/elements/file_field.rb
+lib/celerity/elements/form.rb
+lib/celerity/elements/frame.rb
+lib/celerity/elements/image.rb
+lib/celerity/elements/label.rb
+lib/celerity/elements/link.rb
+lib/celerity/elements/option.rb
+lib/celerity/elements/radio_check.rb
+lib/celerity/elements/select_list.rb
+lib/celerity/elements/table.rb
+lib/celerity/elements/table_body.rb
+lib/celerity/elements/table_cell.rb
+lib/celerity/elements/table_footer.rb
+lib/celerity/elements/table_header.rb
+lib/celerity/elements/table_row.rb
+lib/celerity/elements/text_field.rb
+lib/celerity/exception.rb
+lib/celerity/extra/method_generator.rb
+lib/celerity/htmlunit/commons-codec-1.3.jar
+lib/celerity/htmlunit/commons-collections-3.2.jar
+lib/celerity/htmlunit/commons-httpclient-3.1.jar
+lib/celerity/htmlunit/commons-io-1.4.jar
+lib/celerity/htmlunit/commons-lang-2.4.jar
+lib/celerity/htmlunit/commons-logging-1.1.1.jar
+lib/celerity/htmlunit/cssparser-0.9.5.jar
+lib/celerity/htmlunit/download.sh
+lib/celerity/htmlunit/htmlunit-2.2.jar
+lib/celerity/htmlunit/htmlunit-core-js-2.2.jar
+lib/celerity/htmlunit/nekohtml-1.9.8.jar
+lib/celerity/htmlunit/sac-1.3.jar
+lib/celerity/htmlunit/xalan-2.7.0.jar
+lib/celerity/htmlunit/xercesImpl-2.8.1.jar
+lib/celerity/htmlunit/xml-apis-1.0.b2.jar
+lib/celerity/identifier.rb
+lib/celerity/input_element.rb
+lib/celerity/non_control_elements.rb
+lib/celerity/version.rb
+lib/celerity/watir_compatibility.rb
+spec/area_spec.rb
 spec/areas_spec.rb
-spec/tables_spec.rb
+spec/browser_spec.rb
+spec/button_spec.rb
+spec/buttons_spec.rb
+spec/checkbox_spec.rb
+spec/checkboxes_spec.rb
+spec/div_spec.rb
+spec/divs_spec.rb
+spec/element_spec.rb
+spec/filefield_spec.rb
+spec/filefields_spec.rb
+spec/form_spec.rb
 spec/forms_spec.rb
-spec/uls_spec.rb
-spec/map_spec.rb
-spec/p_spec.rb
+spec/frame_spec.rb
+spec/frames_spec.rb
+spec/hidden_spec.rb
+spec/hiddens_spec.rb
+spec/hn_spec.rb
+spec/hns_spec.rb
+spec/html/2000_spans.html
+spec/html/bug_duplicate_attributes.html
 spec/html/bug_javascript_001.html
-spec/html/images/originaltriangle.jpg
-spec/html/images/circle.jpg
+spec/html/form_js_bug.html
+spec/html/forms_with_input_elements.html
+spec/html/frame_1.html
+spec/html/frame_2.html
+spec/html/frames.html
+spec/html/iframes.html
+spec/html/images.html
 spec/html/images/1.gif
-spec/html/images/square.jpg
-spec/html/images/minus.gif
-spec/html/images/button.jpg
-spec/html/images/map2.gif
+spec/html/images/2.gif
 spec/html/images/3.gif
+spec/html/images/button.jpg
+spec/html/images/circle.jpg
 spec/html/images/map.gif
+spec/html/images/map2.gif
+spec/html/images/minus.gif
+spec/html/images/originaltriangle.jpg
 spec/html/images/plus.gif
+spec/html/images/square.jpg
 spec/html/images/triangle.jpg
-spec/html/images/2.gif
-spec/html/frame_2.html
-spec/html/iframes.html
-spec/html/tables.html
-spec/html/frames.html
-spec/html/2000_spans.html
-spec/html/images.html
+spec/html/invalid_js.html
 spec/html/latin1_text.html
 spec/html/non_control_elements.html
-spec/html/bug_duplicate_attributes.html
-spec/html/frame_1.html
+spec/html/simple_ajax.html
+spec/html/tables.html
 spec/html/utf8_text.html
-spec/html/forms_with_input_elements.html
-spec/images_spec.rb
-spec/spec_helper.rb
-spec/ps_spec.rb
-spec/hn_spec.rb
-spec/filefield_spec.rb
-spec/area_spec.rb
 spec/htmlunit_spec.rb
-spec/labels_spec.rb
-spec/table_cell_spec.rb
-spec/div_spec.rb
-spec/spans_spec.rb
-spec/form_spec.rb
+spec/image_spec.rb
+spec/images_spec.rb
 spec/label_spec.rb
-spec/hns_spec.rb
-spec/table_body_spec.rb
-spec/table_rows_spec.rb
-spec/text_field_spec.rb
-spec/button_spec.rb
-spec/spec.opts
-spec/radio_spec.rb
+spec/labels_spec.rb
+spec/li_spec.rb
+spec/link_spec.rb
 spec/links_spec.rb
-spec/meta_spec.rb
-spec/span_spec.rb
-spec/ie_spec.rb
-spec/checkboxes_spec.rb
-spec/ul_spec.rb
-spec/table_row_spec.rb
-spec/pre_spec.rb
-spec/watir_compatability_spec.rb
-spec/table_header_spec.rb
+spec/lis_spec.rb
+spec/map_spec.rb
 spec/maps_spec.rb
+spec/meta_spec.rb
+spec/ol_spec.rb
+spec/ols_spec.rb
 spec/option_spec.rb
-spec/select_lists_spec.rb
-spec/element_spec.rb
-spec/radios_spec.rb
-spec/frame_spec.rb
+spec/p_spec.rb
+spec/pre_spec.rb
 spec/pres_spec.rb
-spec/table_footer_spec.rb
-spec/filefields_spec.rb
-spec/text_fields_spec.rb
-spec/hidden_spec.rb
-spec/table_footers_spec.rb
-spec/ol_spec.rb
+spec/ps_spec.rb
+spec/radio_spec.rb
+spec/radios_spec.rb
 spec/select_list_spec.rb
-spec/divs_spec.rb
-spec/lis_spec.rb
-spec/ols_spec.rb
-spec/hiddens_spec.rb
+spec/select_lists_spec.rb
+spec/span_spec.rb
+spec/spans_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/table_bodies_spec.rb
+spec/table_body_spec.rb
+spec/table_cell_spec.rb
 spec/table_cells_spec.rb
-spec/li_spec.rb
-spec/link_spec.rb
-spec/image_spec.rb
-config/hoe.rb
-config/requirements.rb
-README.txt
-lib/celerity/input_element.rb
-lib/celerity/watir_compatibility.rb
-lib/celerity/collections.rb
-lib/celerity/container.rb
-lib/celerity/element_locator.rb
-lib/celerity/identifier.rb
-lib/celerity/version.rb
-lib/celerity/extra/method_generator.rb
-lib/celerity/non_control_elements.rb
-lib/celerity/exception.rb
-lib/celerity/clickable_element.rb
-lib/celerity/disabled_element.rb
-lib/celerity/ie.rb
-lib/celerity/element_collections.rb
-lib/celerity/elements/option.rb
-lib/celerity/elements/frame.rb
-lib/celerity/elements/select_list.rb
-lib/celerity/elements/link.rb
-lib/celerity/elements/table_header.rb
-lib/celerity/elements/image.rb
-lib/celerity/elements/label.rb
-lib/celerity/elements/table_cell.rb
-lib/celerity/elements/table_footer.rb
-lib/celerity/elements/table.rb
-lib/celerity/elements/button.rb
-lib/celerity/elements/table_row.rb
-lib/celerity/elements/form.rb
-lib/celerity/elements/table_body.rb
-lib/celerity/elements/radio_check.rb
-lib/celerity/elements/file_field.rb
-lib/celerity/elements/text_field.rb
-lib/celerity/htmlunit/xml-apis-1.0.b2.jar
-lib/celerity/htmlunit/sac-1.3.jar
-lib/celerity/htmlunit/cssparser-0.9.5.jar
-lib/celerity/htmlunit/nekohtml-1.9.7.jar
-lib/celerity/htmlunit/commons-logging-1.1.1.jar
-lib/celerity/htmlunit/commons-codec-1.3.jar
-lib/celerity/htmlunit/js-1.7R1.jar
-lib/celerity/htmlunit/commons-collections-3.2.jar
-lib/celerity/htmlunit/xercesImpl-2.8.1.jar
-lib/celerity/htmlunit/xalan-2.7.0.jar
-lib/celerity/htmlunit/commons-httpclient-3.1.jar
-lib/celerity/htmlunit/htmlunit-2.2-SNAPSHOT.jar
-lib/celerity/htmlunit/commons-io-1.4.jar
-lib/celerity/htmlunit/commons-lang-2.4.jar
-lib/celerity/element.rb
-lib/celerity.rb
+spec/table_footer_spec.rb
+spec/table_footers_spec.rb
+spec/table_header_spec.rb
+spec/table_headers_spec.rb
+spec/table_row_spec.rb
+spec/table_rows_spec.rb
+spec/table_spec.rb
+spec/tables_spec.rb
+spec/text_field_spec.rb
+spec/text_fields_spec.rb
+spec/ul_spec.rb
+spec/uls_spec.rb
+spec/watir_compatibility_spec.rb
 support/spec_server.rb
-support/celerity_viewer/rubycocoa/CelerityViewer.icns
-support/celerity_viewer/rubycocoa/distributed_viewer.rb
-support/celerity_viewer/rubycocoa/README
-support/celerity_viewer/rubycocoa/English.lproj
-support/celerity_viewer/rubycocoa/English.lproj/Main.nib
-support/celerity_viewer/rubycocoa/English.lproj/Main.nib/info.nib
-support/celerity_viewer/rubycocoa/English.lproj/Main.nib/classes.nib
-support/celerity_viewer/rubycocoa/English.lproj/Main.nib/keyedobjects.nib
-support/celerity_viewer/rubycocoa/MainController.rb
-support/celerity_viewer/rubycocoa/main.m
-support/celerity_viewer/rubycocoa/Rakefile
-support/celerity_viewer/rubycocoa/Info.plist.erb
-support/celerity_viewer/rubycocoa/CelerityViewer.app
-support/celerity_viewer/rubycocoa/CelerityViewer.app/Contents
-support/celerity_viewer/rubycocoa/CelerityViewer.app/Contents/MacOS
-support/celerity_viewer/rubycocoa/CelerityViewer.app/Contents/Resources
-support/celerity_viewer/rubycocoa/CelerityViewer.app/Contents/Resources/English.lproj
-support/celerity_viewer/rubycocoa/CelerityViewer.app/Contents/Resources/English.lproj/Main.nib
-support/celerity_viewer/rubycocoa/main.rb
-Manifest.txt
-setup.rb
-License.txt
-tasks/simple_ci.rake
 tasks/rdoc.rake
-tasks/specserver.rake
-tasks/benchmark.rake
-tasks/environment.rake
 tasks/rspec.rake
-benchmark/bm_input_locator.rb
-benchmark/loader.rb
-benchmark/bm_2000_spans.rb
-benchmark/bm_digg.rb
-benchmark/bm_google_images.rb
-Rakefile
+tasks/specserver.rake

data/README.txt

@@ -2,6 +2,10 @@
 
 * http://celerity.rubyforge.org/
 
+== TUTORIAL:
+
+* http://celerity.rubyforge.org/wiki/wiki.pl?GettingStarted
+
 == DESCRIPTION:
 
 Celerity is a JRuby library for easy and fast functional test automation for web applications.
@@ -14,41 +18,32 @@ It is a wrapper around the HtmlUnit Java library and is currently aimed at provi
 * Easy to use: Simple API
 * Portable: Cross-platform
 * Unintrusive: No browser window interrupting your workflow (runs in background)
-
-== SYNOPSIS:
-
-require 'rubygems'
-require 'celerity'
-
-browser = Celerity::IE.new
-browser.goto("google.com")
-browser.text_field(:name, 'q').set("celerity")
-browser.button(:name, 'btnG').submit
 	
 == REQUIREMENTS:
 
-* JRuby 1.1
-	
+* JRuby 1.1 or higher
 * Java 6
 
 == INSTALL:
 
-* jruby -S gem install celerity
+  jruby -S gem install celerity
 
 == EXAMPLE:
-require "celerity" 
 
-browser = Celerity::Browser.new
-browser.goto('http://www.google.com')
-browser.text_field(:name, 'q').value = 'Celerity'
-browser.button(:name, 'btnG').click
+  require "rubygems"
+  require "celerity" 
+
+  browser = Celerity::Browser.new
+  browser.goto('http://www.google.com')
+  browser.text_field(:name, 'q').value = 'Celerity'
+  browser.button(:name, 'btnG').click
 
-puts "yay" if browser.text.include? 'celerity.rubyforge.org'
+  puts "yay" if browser.text.include? 'celerity.rubyforge.org'
 
 == LICENSE:
 
 Celerity - JRuby wrapper for HtmlUnit
-Copyright (c) 2008 FinnTech AS
+Copyright (c) 2008 FINN.no AS
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by

data/lib/celerity.rb

@@ -6,12 +6,18 @@ end
 
 if RUBY_PLATFORM =~ /java/
   require 'java'
+  JavaString = java.lang.String
+  
   Celerity::Jars.each { |jar| require(jar) }
 
   module HtmlUnit
     include_package 'com.gargoylesoftware.htmlunit'
+
+    module Html
+      include_package 'com.gargoylesoftware.htmlunit.html'
+    end
   end
-  JavaString = java.lang.String
+  
 else
   raise "Celerity only works on JRuby at the moment."
 end
@@ -35,7 +41,8 @@ require "celerity/element"
 require "celerity/input_element"
 require "celerity/non_control_elements"
 Dir[File.dirname(__FILE__) + "/celerity/elements/*.rb"].each { |f| require(f) }
-require "celerity/ie"
+require "celerity/element_map"
+require "celerity/browser"
 
 require "celerity/watir_compatibility"
 
@@ -47,6 +54,7 @@ require "time"
 Log = Logger.new($DEBUG ? $stderr : nil)
 Log.level = Logger::DEBUG
 # undefine deprecated methods to use them for Element attributes
-Object.send :undef_method, :id
-Object.send :undef_method, :type
-
+if ["id", "type"].any? { |meth| Object.instance_methods.include?(meth) }
+  Object.send :undef_method, :id
+  Object.send :undef_method, :type
+end

data/lib/celerity/browser.rb

@@ -0,0 +1,296 @@
+module Celerity
+  class Browser
+    include Container
+    attr_accessor :page, :object
+    attr_reader :webclient, :viewer
+    
+    # Initialize a browser and goto the given URL
+    # @param uri The URL to go to.
+    # @return Instance of Celerity::Browser.
+    def self.start(uri)
+      browser = new
+      browser.goto(uri)
+      browser
+    end
+    
+    def self.attach(*args)
+      raise NotImplementedError, "no popup handling yet"
+    end
+    
+    # Creates a browser object.
+    #
+    # @param [Hash[Symbol, Object]] Options for initial configuration of the browser.
+    # 
+    # @option :browser[:firefox, :internet_explorer] Set the BrowserVersion used by HtmlUnit.
+    #        Defaults to Internet Explorer.
+    # @option :css[true, false, nil] Enable CSS. 
+    #        Disabled by default.
+    # @option :secure_ssl[true, false, nil] Disable secure SSL. 
+    #        Enabled by default.
+    # @option :resynchronize[true, false, nil] Use HtmlUnit::NicelyResynchronizingAjaxController to resynchronize Ajax calls.
+    # @option :javascript_exceptions[true, false, nil] Throw exceptions on script errors. 
+    #        Disabled by default.
+    # @option :status_code_exceptions[true, false, nil]Throw exceptions on failing status codes (404 etc.).
+    #        Disabled by default.
+    #
+    # @return [Celerity::Browser]     An instance of the browser.
+    # @api public
+    def initialize(opts = {})
+      raise TypeError, "bad argument: #{opts.inspect}" unless opts.is_a? Hash
+      
+      @opts            = opts
+      @last_url, @page = nil
+      @page_container  = self
+      @error_checkers  = []
+      
+      self.log_level = :warning
+
+      browser = @opts[:browser] == :firefox ? 
+          ::HtmlUnit::BrowserVersion::FIREFOX_2 : ::HtmlUnit::BrowserVersion::INTERNET_EXPLORER_7_0
+          
+      @webclient = ::HtmlUnit::WebClient.new(browser)
+
+      configure_webclient
+      find_viewer 
+    end
+        
+    # Goto the given URL
+    #
+    # @param [String] the url
+    # @return [String] the url
+    def goto(uri)
+      uri = "http://#{uri}" unless uri =~ %r{://}
+      self.page = @webclient.getPage(uri)
+      uri
+    end
+    
+    # Unsets the current page (mostly for Watir compatibility)
+    def close
+      @page = nil
+    end
+
+    # @return [String] the URL of the current page
+    def url
+      assert_exists
+      @page.getWebResponse.getUrl.toString
+    end
+    
+    # @return [String] the title of the current page
+    def title
+      @page ? @page.getTitleText : ''
+    end
+
+    # @return [String] the HTML content of the current page
+    def html
+      @page ? @page.getWebResponse.getContentAsString : ''
+    end
+
+    # @return [String] a text representation of the current page
+    def text
+      return '' unless @page
+
+      if @page.respond_to?("getContent")
+        @page.getContent  
+      else
+        # # this has minimal whitespace
+        @page.documentElement.asText
+        
+        # if @opts[:browser] == :firefox
+        #   # # this is what firewatir does - only works with HtmlUnit::BrowserVersion::FIREFOX_2
+        #   res = execute_script("document.body.textContent").getJavaScriptResult 
+        # else
+        #   # this only works with HtmlUnit::BrowserVersion::INTERNET_EXPLORER_*, and isn't identical to Watir's ole_object.innerText
+        #   res = execute_script("document.body.innerText").getJavaScriptResult 
+        # end
+      end
+    end
+
+    # Check if the current page contains the given text.
+    #
+    # @param  [String, Regexp] expected_text The text to look for.
+    # @return [Numeric, nil]  The index of the matched text, or nil if it doesn't match.
+    def contains_text(expected_text)
+      return nil unless exist?
+      case expected_text
+      when Regexp
+        text() =~ expected_text
+      when String
+        text().index(expected_text)
+      else
+        raise ArgumentError, "Argument must be String or Regexp, but was #{expected_text.inspect}:#{expected_text.class}"
+      end
+    end
+
+    # @return [HtmlUnit::HtmlHtml] the underlying HtmlUnit object.
+    def document
+      @object
+    end
+    
+    # Goto the last url - HtmlUnit doesn't have a 'back' functionality, so we only have 1 history item :)
+    # @return [String, nil] The url of the resulting page, or nil if none was stored.
+    def back
+      # TODO: this is naive, need capability from HtmlUnit  
+      goto(@last_url) if @last_url
+    end
+    
+    # Refresh the current page
+    def refresh
+      assert_exists
+      self.page = @page.refresh
+    end
+
+    # Execute the given JavaScript on the current page
+    # @return [HtmlUnit::ScriptResult]
+    def execute_script(source)
+      assert_exists
+      @page.executeJavaScript(source.to_s)
+    end
+
+    # Add a 'checker' proc that will be run on every page load
+    # 
+    # @param [Proc] checker the proc to be run (can also be given as a block)
+    # @raise [ArgumentError] if no Proc or block was given.
+    def add_checker(checker = nil, &block)
+      if block_given?
+        @error_checkers << block
+      elsif Proc === checker
+        @error_checkers << checker
+      else
+        raise ArgumentError, "argument must be a Proc or block"
+      end
+    end
+    
+    # Remove the given checker from the list of checkers
+    # @param [Proc] the Proc to disable
+    def disable_checker(checker)
+      @error_checkers.delete(checker)
+    end
+
+    # Set Java log level (default is :warning)
+    #
+    # @param [Symbol] level :finest, :finer, :fine, :config, :info, :warning, :severe, or :off, :all
+    def log_level=(level)
+      java.util.logging.Logger.getLogger('com.gargoylesoftware.htmlunit').level = java.util.logging.Level.const_get(level.to_s.upcase)
+    end
+    
+    # @return [Symbol] the current log level
+    def log_level
+      java.util.logging.Logger.getLogger('com.gargoylesoftware.htmlunit').level.to_s.downcase.to_sym
+    end
+
+    # Checks if we have a page currently loaded. 
+    # @return [true, false]
+    def exist?
+      !!@page
+    end
+    alias_method :exists?, :exist?
+
+    # Allows you to temporarily switch to HtmlUnit's NicelyResynchronizingAjaxController to resynchronize ajax calls.
+    #
+    # Example:
+    #   @browser.resynchroniced do |b|
+    #     b.link(:id, 'load_fancy_ajax_stuff').click
+    #   end
+    #
+    # @param [block] &block the block to execute synchronized.
+    def resynchronized(&block)
+      old_controller = @webclient.ajaxController
+      @webclient.setAjaxController(::HtmlUnit::NicelyResynchronizingAjaxController.new)
+      yield self
+      @webclient.setAjaxController(old_controller)
+    end
+
+    #--
+    # TODO: could be private?
+    #++
+    #
+    # Check that we have a @page object.
+    # 
+    # @raise UnknownObjectException
+    # @api internal
+    def assert_exists
+      raise UnknownObjectException, "no page loaded" unless exist?
+    end
+    
+    #--
+    # TODO: could be private?
+    #++
+    # Runs the all the checker procs added by +add_checker+
+    #
+    # @see add_checker
+    # @api internal
+    def run_error_checks
+      @error_checkers.each { |e| e.call(self) }
+    end
+    
+    # Set the current page object for the browser
+    #
+    # @param [HtmlUnit::HtmlPage] value The page to set.
+    # @api internal
+    def page=(value)
+      @last_url = url() if exist?
+      @page = value
+      
+      if @page.respond_to?("getDocumentElement")
+        @object = @page.getDocumentElement
+      end
+      
+      render if @viewer
+      run_error_checks
+      
+      value
+    end
+
+    # Used for #show_links(), #show_divs() etc. (for watir compatibility)
+    def method_missing(meth, *args)
+      return super unless type = meth.to_s[/^show_(.*)$/, 1]
+      puts collection_string(type) rescue super
+    end
+
+    private
+    
+    # Configure the webclient according to the options given to #new.
+    # @see initialize
+    def configure_webclient
+      @webclient.throwExceptionOnScriptError = false unless @opts[:javascript_exceptions]
+      @webclient.throwExceptionOnFailingStatusCode = false unless @opts[:status_code_exceptions]
+      @webclient.cssEnabled = false unless @opts[:css]
+      @webclient.useInsecureSSL = true if @opts[:secure_ssl] 
+      @webclient.setAjaxController(::HtmlUnit::NicelyResynchronizingAjaxController.new) if @opts[:resynchronize]
+    end
+
+    # Create a string representation of all the elements returned by collection_method
+    # @param [Symbol] collection_method
+    # @return [String] 
+    def collection_string(collection_method)
+      collection = self.send collection_method
+      result = "Found #{collection.size} #{collection_method.downcase}\n"
+      
+      collection.each_with_index do |element, index|
+        result << "#{index+1}: #{element.attribute_string}\n"
+      end
+      
+      result
+    end
+    
+    # Render the current page on the viewer.
+    # @api internal
+    def render
+      @viewer.render_html(html, url) 
+    rescue DRb::DRbConnError, Errno::ECONNREFUSED => e
+      @viewer = nil
+    end    
+    
+    # Check if we have a viewer available on druby://127.0.0.1:6429
+    # @api internal
+    def find_viewer
+      # FIXME: not ideal
+      require 'drb'
+      viewer = DRbObject.new_with_uri("druby://127.0.0.1:6429")
+      @viewer = viewer if viewer.respond_to?(:render_html)
+    rescue DRb::DRbConnError, Errno::ECONNREFUSED
+      @viewer = nil
+    end
+    
+  end # Browser
+end # Celerity