capybara 0.4.1.2 → 1.0.0.beta1

data/lib/capybara/selector.rb

@@ -2,6 +2,13 @@ module Capybara
   class Selector
     attr_reader :name
 
+    class Normalized
+      attr_accessor :selector, :locator, :options, :xpaths
+
+      def failure_message; selector.failure_message; end
+      def name; selector.name; end
+    end
+
     class << self
       def all
         @selectors ||= {}
@@ -15,19 +22,26 @@ module Capybara
         all.delete(name.to_sym)
       end
 
-      def normalize(name_or_locator, locator=nil)
-        xpath = if locator
-          all[name_or_locator.to_sym].call(locator)
+      def normalize(*args)
+        normalized = Normalized.new
+        normalized.options = if args.last.is_a?(Hash) then args.pop else {} end
+
+        if args[1]
+          normalized.selector = all[args[0]]
+          normalized.locator = args[1]
         else
-          selector = all.values.find { |s| s.match?(name_or_locator) }
-          selector ||= all[Capybara.default_selector]
-          selector.call(name_or_locator)
+          normalized.selector = all.values.find { |s| s.match?(args[0]) }
+          normalized.locator = args[0]
         end
+        normalized.selector ||= all[Capybara.default_selector]
+
+        xpath = normalized.selector.call(normalized.locator)
         if xpath.respond_to?(:to_xpaths)
-          xpath.to_xpaths
+          normalized.xpaths = xpath.to_xpaths
         else
-          [xpath.to_s].flatten
+          normalized.xpaths = [xpath.to_s].flatten
         end
+        normalized
       end
     end
 
@@ -46,6 +60,11 @@ module Capybara
       @match
     end
 
+    def failure_message(&block)
+      @failure_message = block if block
+      @failure_message
+    end
+
     def call(locator)
       @xpath.call(locator)
     end

data/lib/capybara/selenium/driver.rb

@@ -0,0 +1,148 @@
+require 'selenium-webdriver'
+
+class Capybara::Selenium::Driver < Capybara::Driver::Base
+  DEFAULT_OPTIONS = {
+    :resynchronize => true,
+    :resynchronization_timeout => 10,
+    :browser => :firefox
+  }
+  SPECIAL_OPTIONS = [:browser, :resynchronize, :resynchronization_timeout]
+
+  attr_reader :app, :rack_server, :options
+
+  def browser
+    unless @browser
+      @browser = Selenium::WebDriver.for(options[:browser], options.reject { |key,val| SPECIAL_OPTIONS.include?(key) })
+      at_exit do
+        @browser.quit
+      end
+    end
+    @browser
+  end
+
+  def initialize(app, options={})
+    @app = app
+    @options = DEFAULT_OPTIONS.merge(options)
+    @rack_server = Capybara::Server.new(@app)
+    @rack_server.boot if Capybara.run_server
+  end
+
+  def visit(path)
+    browser.navigate.to(url(path))
+  end
+
+  def source
+    browser.page_source
+  end
+
+  def body
+    browser.page_source
+  end
+
+  def current_url
+    browser.current_url
+  end
+
+  def find(selector)
+    browser.find_elements(:xpath, selector).map { |node| Capybara::Selenium::Node.new(self, node) }
+  end
+
+  def wait?; true; end
+
+  def resynchronize
+    if options[:resynchronize]
+      load_wait_for_ajax_support
+      yield
+      Capybara.timeout(options[:resynchronization_timeout], self, "failed to resynchronize, ajax request timed out") do
+        evaluate_script("!window.capybaraRequestsOutstanding")
+      end
+    else
+      yield
+    end
+  end
+
+  def execute_script(script)
+    browser.execute_script script
+  end
+
+  def evaluate_script(script)
+    browser.execute_script "return #{script}"
+  end
+
+  def reset!
+    # Use instance variable directly so we avoid starting the browser just to reset the session
+    if @browser
+      begin
+        @browser.manage.delete_all_cookies
+      rescue Selenium::WebDriver::Error::UnhandledError => e
+        # delete_all_cookies fails when we've previously gone
+        # to about:blank, so we rescue this error and do nothing
+        # instead.
+      end
+      @browser.navigate.to('about:blank')
+    end
+  end
+
+  def within_frame(frame_id)
+    old_window = browser.window_handle
+    browser.switch_to.frame(frame_id)
+    yield
+    browser.switch_to.window old_window
+  end
+
+  def find_window( selector )
+    original_handle = browser.window_handle
+    browser.window_handles.each do |handle|
+      browser.switch_to.window handle
+      if( selector == browser.execute_script("return window.name") ||
+          browser.title.include?(selector) ||
+          browser.current_url.include?(selector) ||
+          (selector == handle) )
+        browser.switch_to.window original_handle
+        return handle
+      end
+    end
+    raise Capybara::ElementNotFound, "Could not find a window identified by #{selector}"
+  end
+
+  def within_window(selector, &blk)
+    handle = find_window( selector )
+    browser.switch_to.window(handle, &blk)
+  end
+
+private
+
+  def load_wait_for_ajax_support
+    browser.execute_script <<-JS
+      window.capybaraRequestsOutstanding = 0;
+      (function() { // Overriding XMLHttpRequest
+          var oldXHR = window.XMLHttpRequest;
+
+          function newXHR() {
+              var realXHR = new oldXHR();
+
+              window.capybaraRequestsOutstanding++;
+              realXHR.addEventListener("readystatechange", function() {
+                  if( realXHR.readyState == 4 ) {
+                    setTimeout( function() {
+                      window.capybaraRequestsOutstanding--;
+                      if(window.capybaraRequestsOutstanding < 0) {
+                        window.capybaraRequestsOutstanding = 0;
+                      }
+                    }, 500 );
+                  }
+              }, false);
+
+              return realXHR;
+          }
+
+          window.XMLHttpRequest = newXHR;
+      })();
+    JS
+  end
+
+  def url(path)
+    rack_server.url(path)
+  end
+
+end

data/lib/capybara/selenium/node.rb

@@ -0,0 +1,91 @@
+class Capybara::Selenium::Node < Capybara::Driver::Node
+  def text
+    native.text
+  end
+
+  def [](name)
+    if name == :value
+      value
+    else
+      native.attribute(name.to_s)
+    end
+  rescue Selenium::WebDriver::Error::WebDriverError
+    nil
+  end
+
+  def value
+    if tag_name == "select" and self[:multiple] and not self[:multiple] == "false"
+      native.find_elements(:xpath, ".//option").select { |n| n.selected? }.map { |n| n.value || n.text }
+    else
+      native.value
+    end
+  end
+
+  def set(value)
+    if tag_name == 'input' and type == 'radio'
+      click
+    elsif tag_name == 'input' and type == 'checkbox'
+      click if value ^ native.attribute('checked').to_s.eql?("true")
+    elsif tag_name == 'textarea' or tag_name == 'input'
+      resynchronize do
+        native.clear
+        native.send_keys(value.to_s)
+      end
+    end
+  end
+
+  def select_option
+    resynchronize { native.select }
+  end
+
+  def unselect_option
+    if select_node['multiple'] != 'multiple' and select_node['multiple'] != 'true'
+      raise Capybara::UnselectNotAllowed, "Cannot unselect option from single select box."
+    end
+    resynchronize { native.toggle } if selected?
+  end
+
+  def click
+    resynchronize { native.click }
+  end
+
+  def drag_to(element)
+    resynchronize { native.drag_and_drop_on(element.native) }
+  end
+
+  def tag_name
+    native.tag_name
+  end
+
+  def visible?
+    displayed = native.displayed?
+    displayed and displayed != "false"
+  end
+
+  def selected?
+    selected = native.selected?
+    selected and selected != "false"
+  end
+
+  alias :checked? :selected?
+
+  def find(locator)
+    native.find_elements(:xpath, locator).map { |n| self.class.new(driver, n) }
+  end
+
+private
+
+  def resynchronize
+    driver.resynchronize { yield }
+  end
+
+  # a reference to the select node if this is an option node
+  def select_node
+    find('./ancestor::select').first
+  end
+
+  def type
+    self[:type]
+  end
+
+end

data/lib/capybara/session.rb

@@ -26,14 +26,24 @@ module Capybara
   # When using capybara/dsl, the Session is initialized automatically for you.
   #
   class Session
-    DSL_METHODS = [
-      :all, :first, :attach_file, :body, :check, :choose, :click_link_or_button, :click_button, :click_link, :current_url, :drag, :evaluate_script,
-      :field_labeled, :fill_in, :find, :find_button, :find_by_id, :find_field, :find_link, :has_content?, :has_css?,
-      :has_no_content?, :has_no_css?, :has_no_xpath?, :has_xpath?, :locate, :save_and_open_page, :select, :source, :uncheck,
-      :visit, :wait_until, :within, :within_fieldset, :within_table, :within_frame, :within_window, :has_link?, :has_no_link?, :has_button?,
-      :has_no_button?, :has_field?, :has_no_field?, :has_checked_field?, :has_unchecked_field?, :has_no_table?, :has_table?,
-      :unselect, :has_select?, :has_no_select?, :current_path, :click, :has_selector?, :has_no_selector?, :click_on
+    NODE_METHODS = [
+      :all, :first, :attach_file, :text, :check, :choose,
+      :click_link_or_button, :click_button, :click_link, :field_labeled,
+      :fill_in, :find, :find_button, :find_by_id, :find_field, :find_link,
+      :has_content?, :has_css?, :has_no_content?, :has_no_css?, :has_no_xpath?,
+      :has_xpath?, :select, :uncheck, :has_link?, :has_no_link?, :has_button?,
+      :has_no_button?, :has_field?, :has_no_field?, :has_checked_field?,
+      :has_unchecked_field?, :has_no_table?, :has_table?, :unselect,
+      :has_select?, :has_no_select?, :has_selector?, :has_no_selector?,
+      :click_on, :has_no_checked_field?, :has_no_unchecked_field?
     ]
+    SESSION_METHODS = [
+      :body, :html, :current_url, :current_host, :evaluate_script, :source,
+      :visit, :wait_until, :within, :within_fieldset, :within_table,
+      :within_frame, :within_window, :current_path, :save_page,
+      :save_and_open_page, :reset_session!
+    ]
+    DSL_METHODS = NODE_METHODS + SESSION_METHODS
 
     attr_reader :mode, :app
 
@@ -60,6 +70,7 @@ module Capybara
       driver.reset!
     end
     alias_method :cleanup!, :reset!
+    alias_method :reset_session!, :reset!
 
     ##
     #
@@ -83,11 +94,12 @@ module Capybara
 
     ##
     #
-    # @return [String] A snapshot of the HTML of the current document, as it looks right now
+    # @return [String] A snapshot of the HTML of the current document, as it looks right now (potentially modified by JavaScript).
     #
     def body
       driver.body
     end
+    alias_method :html, :body
 
     ##
     #
@@ -102,7 +114,17 @@ module Capybara
     # @return [String] Path of the current page, without any domain information
     #
     def current_path
-      URI.parse(current_url).path
+      path = URI.parse(current_url).path
+      path if path and not path.empty?
+    end
+
+    ##
+    #
+    # @return [String] Host of the current page
+    #
+    def current_host
+      uri = URI.parse(current_url)
+      "#{uri.scheme}://#{uri.host}" if uri.host
     end
 
     ##
@@ -251,6 +273,11 @@ module Capybara
     #
     # Save a snapshot of the page and open it in a browser for inspection
     #
+    def save_page
+      require 'capybara/util/save_and_open_page'
+      Capybara.save_page(body)
+    end
+
     def save_and_open_page
       require 'capybara/util/save_and_open_page'
       Capybara.save_and_open_page(body)
@@ -260,12 +287,12 @@ module Capybara
       Capybara::Node::Document.new(self, driver)
     end
 
-    def method_missing(*args)
-      current_node.send(*args)
-    end
-
-    def respond_to?(method)
-      super || current_node.respond_to?(method)
+    NODE_METHODS.each do |method|
+      class_eval <<-RUBY
+        def #{method}(*args, &block)
+          current_node.send(:#{method}, *args, &block)
+        end
+      RUBY
     end
 
   private

data/lib/capybara/spec/driver.rb

@@ -26,6 +26,20 @@ shared_examples_for 'driver' do
       @driver.visit('/with_simple_html')
       @driver.body.should include('Bar')
     end
+
+    if "".respond_to?(:encoding)
+      context "encoding of response between ascii and utf8" do
+        it "should be valid with html entities" do
+          @driver.visit('/with_html_entities')
+          lambda { @driver.body.encode!("UTF-8") }.should_not raise_error
+        end
+
+        it "should be valid without html entities" do
+          @driver.visit('/with_html')
+          lambda { @driver.body.encode!("UTF-8") }.should_not raise_error
+        end
+      end
+    end
   end
 
   describe '#find' do
@@ -85,6 +99,11 @@ shared_examples_for 'driver' do
         @driver.find('//option[@value="sv"]')[0].should_not be_selected
         @driver.find('//h1')[0].should_not be_selected
       end
+
+      it "should return document text on /html selector" do
+        @driver.visit('/with_simple_html')
+        @driver.find('/html')[0].text.should == 'Bar'
+      end
     end
   end
 end
@@ -100,7 +119,6 @@ shared_examples_for "driver with javascript support" do
 
   describe '#drag_to' do
     it "should drag and drop an object" do
-      pending "drag/drop is currently broken under celerity/culerity" if @driver.is_a?(Capybara::Driver::Celerity)
       draggable = @driver.find('//div[@id="drag"]').first
       droppable = @driver.find('//div[@id="drop"]').first
       draggable.drag_to(droppable)
@@ -113,6 +131,42 @@ shared_examples_for "driver with javascript support" do
       @driver.evaluate_script('1+1').should == 2
     end
   end
+
+end
+
+shared_examples_for "driver with resynchronization support" do
+  before { @driver.visit('/with_js') }
+  describe "#find" do
+    context "with synchronization turned on" do
+      it "should wait for all ajax requests to finish" do
+        @driver.find('//input[@id="fire_ajax_request"]').first.click
+        @driver.find('//p[@id="ajax_request_done"]').should_not be_empty
+      end
+    end
+
+    context "with resynchronization turned off" do
+      before { @driver.options[:resynchronize] = false }
+
+      it "should not wait for ajax requests to finish" do
+        @driver.find('//input[@id="fire_ajax_request"]').first.click
+        @driver.find('//p[@id="ajax_request_done"]').should be_empty
+      end
+
+      after { @driver.options[:resynchronize] = true }
+    end
+
+    context "with short synchronization timeout" do
+      before { @driver.options[:resynchronization_timeout] = 0.1 }
+
+      it "should raise an error" do
+        expect do
+          @driver.find('//input[@id="fire_ajax_request"]').first.click
+        end.to raise_error(Capybara::TimeoutError, "failed to resynchronize, ajax request timed out")
+      end
+
+      after { @driver.options[:resynchronization_timeout] = 10 }
+    end
+  end
 end
 
 shared_examples_for "driver with header support" do