jarib-celerity 0.0.5.8 → 0.0.5.9

data/lib/celerity/browser.rb

@@ -6,7 +6,7 @@ module Celerity
     attr_reader :webclient, :viewer
 
     #
-    # Initialize a browser and goto the given URL
+    # Initialize a browser and go to the given URL
     # 
     # @param [String] uri The URL to go to.
     # @return [Celerity::Browser] instance.
@@ -215,8 +215,12 @@ module Celerity
     end
 
     #
-    # write me!
+    # Get the first element found matching the given XPath.
     #
+    # @param [String] xpath
+    # @return [Celerity::Element] An element subclass (or Element if none is found)
+    #
+    
     def element_by_xpath(xpath)
       assert_exists
       obj = @page.getFirstByXPath(xpath)
@@ -224,8 +228,12 @@ module Celerity
     end
 
     #
-    # write me!
+    # Get all the elements matching the given XPath.
     #
+    # @param [String] xpath
+    # @retrun [Array<Celerity::Element>] array of elements
+    #
+    
     def elements_by_xpath(xpath)
       assert_exists
       objects = @page.getByXPath(xpath)
@@ -293,7 +301,7 @@ module Celerity
     end
 
     #
-    # Execute the given JavaScript on the current page. (Celerity only)
+    # Execute the given JavaScript on the current page.
     # @return [Object] The resulting Object
     #
 
@@ -356,19 +364,32 @@ module Celerity
     # Allows you to temporarily switch to HtmlUnit's NicelyResynchronizingAjaxController to resynchronize ajax calls.
     #
     #   @browser.resynchronized do |b|
-    #     b.link(:id, 'load_fancy_ajax_stuff').click
+    #     b.link(:id, 'trigger_ajax_call').click
     #   end
     #
     # @yieldparam [Celerity::Browser] browser The current browser object.
-    # @see Celerity::Browser#new for options on how to always use this.
+    # @see Celerity::Browser#new for how to configure the browser to always use this.
     #
 
     def resynchronized(&block)
       old_controller = @webclient.ajaxController
       @webclient.setAjaxController(::HtmlUnit::NicelyResynchronizingAjaxController.new)
-
-      yield(self)
-
+      yield self
+      @webclient.setAjaxController(old_controller)
+    end
+    
+    #
+    # Allows you to temporarliy switch to HtmlUnit's default AjaxController, so ajax calls are performed asynchronously.
+    # This is useful if you have created the Browser with :resynchronize => true, but want to switch it off temporarily.
+    # 
+    # @yieldparam [Celerity::Browser] browser The current browser object.
+    # @see Celerity::Browser#new
+    #
+    
+    def asynchronized(&block)
+      old_controller = @webclient.ajaxController
+      @webclient.setAjaxController(::HtmlUnit::AjaxController.new)
+      yield self
       @webclient.setAjaxController(old_controller)
     end
 

data/lib/celerity/version.rb

@@ -3,7 +3,7 @@ module Celerity #:nodoc:
     MAJOR = 0
     MINOR = 0
     TINY  = 5
-    PATCH = 8 # Set to nil for official release
+    PATCH = 9 # Set to nil for official release
     
     STRING = [MAJOR, MINOR, TINY, PATCH].compact.join('.')
   end

data/lib/celerity/watir_compatibility.rb

@@ -78,6 +78,8 @@ module Celerity
     alias_method :dragContentsTo,   :drag_contents_to
     alias_method :getContents,      :value
     alias_method :get_contents,     :value
+    
+    def requires_typing; end
   end
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: jarib-celerity
 version: !ruby/object:Gem::Version 
-  version: 0.0.5.8
+  version: 0.0.5.9
 platform: ruby
 authors: 
 - Jari Bakken
@@ -11,7 +11,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-02-24 00:00:00 -08:00
+date: 2009-03-05 00:00:00 -08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -22,7 +22,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.8.3
+        version: 1.9.0
     version: 
 description: "Celerity is a JRuby wrapper around HtmlUnit \xE2\x80\x93 a headless Java browser with JavaScript support. It provides a simple API for programmatic navigation through web applications. Celerity aims at being API compatible with Watir."
 email: jari.bakken@finn.no