mirror of
https://github.com/teamcapybara/capybara.git
synced 2022-11-09 12:08:07 -05:00
Split node class into finders, matchers and actions
This commit is contained in:
Jonas Nicklas
parent
d1c6cd4290
commit
8bf63ee8e4
4 changed files with 239 additions and 214 deletions
|
|
@ -1,230 +1,24 @@
|
||||||
|
require 'capybara/node/finders'
|
||||||
|
require 'capybara/node/actions'
|
||||||
|
require 'capybara/node/matchers'
|
||||||
|
|
||||||
module Capybara
|
module Capybara
|
||||||
class Node
|
class Node
|
||||||
attr_reader :session, :base
|
attr_reader :session, :base
|
||||||
|
|
||||||
|
include Capybara::Node::Finders
|
||||||
|
include Capybara::Node::Actions
|
||||||
|
include Capybara::Node::Matchers
|
||||||
|
|
||||||
def initialize(session, base)
|
def initialize(session, base)
|
||||||
@session = session
|
@session = session
|
||||||
@base = base
|
@base = base
|
||||||
end
|
end
|
||||||
|
|
||||||
def click_link_or_button(locator)
|
|
||||||
msg = "no link or button '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.link(locator).button(locator), msg).click
|
|
||||||
end
|
|
||||||
|
|
||||||
def click_link(locator)
|
|
||||||
msg = "no link with title, id or text '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.link(locator), msg).click
|
|
||||||
end
|
|
||||||
|
|
||||||
def click_button(locator)
|
|
||||||
msg = "no button with value or id or text '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.button(locator), msg).click
|
|
||||||
end
|
|
||||||
|
|
||||||
def drag(source_locator, target_locator)
|
|
||||||
source = locate(:xpath, source_locator, "drag source '#{source_locator}' not found on page")
|
|
||||||
target = locate(:xpath, target_locator, "drag target '#{target_locator}' not found on page")
|
|
||||||
source.drag_to(target)
|
|
||||||
end
|
|
||||||
|
|
||||||
def fill_in(locator, options={})
|
|
||||||
msg = "cannot fill in, no text field, text area or password field with id, name, or label '#{locator}' found"
|
|
||||||
raise "Must pass a hash containing 'with'" if not options.is_a?(Hash) or not options.has_key?(:with)
|
|
||||||
locate(:xpath, XPath.fillable_field(locator), msg).set(options[:with])
|
|
||||||
end
|
|
||||||
|
|
||||||
def choose(locator)
|
|
||||||
msg = "cannot choose field, no radio button with id, name, or label '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.radio_button(locator), msg).set(true)
|
|
||||||
end
|
|
||||||
|
|
||||||
def check(locator)
|
|
||||||
msg = "cannot check field, no checkbox with id, name, or label '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.checkbox(locator), msg).set(true)
|
|
||||||
end
|
|
||||||
|
|
||||||
def uncheck(locator)
|
|
||||||
msg = "cannot uncheck field, no checkbox with id, name, or label '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.checkbox(locator), msg).set(false)
|
|
||||||
end
|
|
||||||
|
|
||||||
def select(value, options={})
|
|
||||||
msg = "cannot select option, no select box with id, name, or label '#{options[:from]}' found"
|
|
||||||
locate(:xpath, XPath.select(options[:from]), msg).select_option(value)
|
|
||||||
end
|
|
||||||
|
|
||||||
def unselect(value, options={})
|
|
||||||
msg = "cannot unselect option, no select box with id, name, or label '#{options[:from]}' found"
|
|
||||||
locate(:xpath, XPath.select(options[:from]), msg).unselect_option(value)
|
|
||||||
end
|
|
||||||
|
|
||||||
def attach_file(locator, path)
|
|
||||||
msg = "cannot attach file, no file field with id, name, or label '#{locator}' found"
|
|
||||||
locate(:xpath, XPath.file_field(locator), msg).set(path)
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_xpath?(path, options={})
|
|
||||||
wait_conditionally_until do
|
|
||||||
results = all(:xpath, path, options)
|
|
||||||
|
|
||||||
if options[:count]
|
|
||||||
results.size == options[:count]
|
|
||||||
else
|
|
||||||
results.size > 0
|
|
||||||
end
|
|
||||||
end
|
|
||||||
rescue Capybara::TimeoutError
|
|
||||||
return false
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_xpath?(path, options={})
|
|
||||||
wait_conditionally_until do
|
|
||||||
results = all(:xpath, path, options)
|
|
||||||
|
|
||||||
if options[:count]
|
|
||||||
results.size != options[:count]
|
|
||||||
else
|
|
||||||
results.empty?
|
|
||||||
end
|
|
||||||
end
|
|
||||||
rescue Capybara::TimeoutError
|
|
||||||
return false
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_css?(path, options={})
|
|
||||||
has_xpath?(XPath.from_css(path), options)
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_css?(path, options={})
|
|
||||||
has_no_xpath?(XPath.from_css(path), options)
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_content?(content)
|
|
||||||
has_xpath?(XPath.content(content))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_content?(content)
|
|
||||||
has_no_xpath?(XPath.content(content))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_link?(locator)
|
|
||||||
has_xpath?(XPath.link(locator))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_link?(locator)
|
|
||||||
has_no_xpath?(XPath.link(locator))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_button?(locator)
|
|
||||||
has_xpath?(XPath.button(locator))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_button?(locator)
|
|
||||||
has_no_xpath?(XPath.button(locator))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_field?(locator, options={})
|
|
||||||
has_xpath?(XPath.field(locator, options))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_field?(locator, options={})
|
|
||||||
has_no_xpath?(XPath.field(locator, options))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_checked_field?(locator)
|
|
||||||
has_xpath?(XPath.field(locator, :checked => true))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_unchecked_field?(locator)
|
|
||||||
has_xpath?(XPath.field(locator, :unchecked => true))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_select?(locator, options={})
|
|
||||||
has_xpath?(XPath.select(locator, options))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_select?(locator, options={})
|
|
||||||
has_no_xpath?(XPath.select(locator, options))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_table?(locator, options={})
|
|
||||||
has_xpath?(XPath.table(locator, options))
|
|
||||||
end
|
|
||||||
|
|
||||||
def has_no_table?(locator, options={})
|
|
||||||
has_no_xpath?(XPath.table(locator, options))
|
|
||||||
end
|
|
||||||
|
|
||||||
#return node identified by locator or raise ElementNotFound(using desc)
|
|
||||||
def locate(kind_or_locator, locator=nil, fail_msg = nil)
|
|
||||||
node = wait_conditionally_until { find(kind_or_locator, locator) }
|
|
||||||
ensure
|
|
||||||
raise Capybara::ElementNotFound, fail_msg || "Unable to locate '#{locator || kind_or_locator}'" unless node
|
|
||||||
return node
|
|
||||||
end
|
|
||||||
|
|
||||||
def find(*args)
|
|
||||||
all(*args).first
|
|
||||||
end
|
|
||||||
|
|
||||||
def find_field(locator)
|
|
||||||
find(:xpath, XPath.field(locator))
|
|
||||||
end
|
|
||||||
alias_method :field_labeled, :find_field
|
|
||||||
|
|
||||||
def find_link(locator)
|
|
||||||
find(:xpath, XPath.link(locator))
|
|
||||||
end
|
|
||||||
|
|
||||||
def find_button(locator)
|
|
||||||
find(:xpath, XPath.button(locator))
|
|
||||||
end
|
|
||||||
|
|
||||||
def find_by_id(id)
|
|
||||||
find(:css, "##{id}")
|
|
||||||
end
|
|
||||||
|
|
||||||
def all(*args)
|
|
||||||
options = if args.last.is_a?(Hash) then args.pop else {} end
|
|
||||||
|
|
||||||
results = XPath.wrap(normalize_locator(*args)).paths.map do |path|
|
|
||||||
base.find(path)
|
|
||||||
end.flatten
|
|
||||||
|
|
||||||
if options[:text]
|
|
||||||
|
|
||||||
if options[:text].kind_of?(Regexp)
|
|
||||||
regexp = options[:text]
|
|
||||||
else
|
|
||||||
regexp = Regexp.escape(options[:text])
|
|
||||||
end
|
|
||||||
|
|
||||||
results = results.select { |n| n.text.match(regexp) }
|
|
||||||
end
|
|
||||||
|
|
||||||
if options[:visible] or Capybara.ignore_hidden_elements
|
|
||||||
results = results.select { |n| n.visible? }
|
|
||||||
end
|
|
||||||
|
|
||||||
results.map { |n| Capybara::Element.new(self, n) }
|
|
||||||
end
|
|
||||||
|
|
||||||
protected
|
protected
|
||||||
|
|
||||||
def normalize_locator(kind, locator=nil)
|
|
||||||
kind, locator = Capybara.default_selector, kind if locator.nil?
|
|
||||||
locator = XPath.from_css(locator) if kind == :css
|
|
||||||
locator
|
|
||||||
end
|
|
||||||
|
|
||||||
def driver
|
def driver
|
||||||
session.driver
|
session.driver
|
||||||
end
|
end
|
||||||
|
|
||||||
def wait_conditionally_until
|
|
||||||
if driver.wait? then wait_until { yield } else yield end
|
|
||||||
end
|
|
||||||
|
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
|
||||||
62
lib/capybara/node/actions.rb
Normal file
62
lib/capybara/node/actions.rb
Normal file
|
|
@ -0,0 +1,62 @@
|
||||||
|
module Capybara
|
||||||
|
class Node
|
||||||
|
module Actions
|
||||||
|
def click_link_or_button(locator)
|
||||||
|
msg = "no link or button '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.link(locator).button(locator), msg).click
|
||||||
|
end
|
||||||
|
|
||||||
|
def click_link(locator)
|
||||||
|
msg = "no link with title, id or text '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.link(locator), msg).click
|
||||||
|
end
|
||||||
|
|
||||||
|
def click_button(locator)
|
||||||
|
msg = "no button with value or id or text '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.button(locator), msg).click
|
||||||
|
end
|
||||||
|
|
||||||
|
def fill_in(locator, options={})
|
||||||
|
msg = "cannot fill in, no text field, text area or password field with id, name, or label '#{locator}' found"
|
||||||
|
raise "Must pass a hash containing 'with'" if not options.is_a?(Hash) or not options.has_key?(:with)
|
||||||
|
locate(:xpath, XPath.fillable_field(locator), msg).set(options[:with])
|
||||||
|
end
|
||||||
|
|
||||||
|
def choose(locator)
|
||||||
|
msg = "cannot choose field, no radio button with id, name, or label '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.radio_button(locator), msg).set(true)
|
||||||
|
end
|
||||||
|
|
||||||
|
def check(locator)
|
||||||
|
msg = "cannot check field, no checkbox with id, name, or label '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.checkbox(locator), msg).set(true)
|
||||||
|
end
|
||||||
|
|
||||||
|
def uncheck(locator)
|
||||||
|
msg = "cannot uncheck field, no checkbox with id, name, or label '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.checkbox(locator), msg).set(false)
|
||||||
|
end
|
||||||
|
|
||||||
|
def select(value, options={})
|
||||||
|
msg = "cannot select option, no select box with id, name, or label '#{options[:from]}' found"
|
||||||
|
locate(:xpath, XPath.select(options[:from]), msg).select_option(value)
|
||||||
|
end
|
||||||
|
|
||||||
|
def unselect(value, options={})
|
||||||
|
msg = "cannot unselect option, no select box with id, name, or label '#{options[:from]}' found"
|
||||||
|
locate(:xpath, XPath.select(options[:from]), msg).unselect_option(value)
|
||||||
|
end
|
||||||
|
|
||||||
|
def attach_file(locator, path)
|
||||||
|
msg = "cannot attach file, no file field with id, name, or label '#{locator}' found"
|
||||||
|
locate(:xpath, XPath.file_field(locator), msg).set(path)
|
||||||
|
end
|
||||||
|
|
||||||
|
def drag(source_locator, target_locator)
|
||||||
|
source = locate(:xpath, source_locator, "drag source '#{source_locator}' not found on page")
|
||||||
|
target = locate(:xpath, target_locator, "drag target '#{target_locator}' not found on page")
|
||||||
|
source.drag_to(target)
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
72
lib/capybara/node/finders.rb
Normal file
72
lib/capybara/node/finders.rb
Normal file
|
|
@ -0,0 +1,72 @@
|
||||||
|
module Capybara
|
||||||
|
class Node
|
||||||
|
module Finders
|
||||||
|
#return node identified by locator or raise ElementNotFound(using desc)
|
||||||
|
def locate(kind_or_locator, locator=nil, fail_msg = nil)
|
||||||
|
node = wait_conditionally_until { find(kind_or_locator, locator) }
|
||||||
|
ensure
|
||||||
|
raise Capybara::ElementNotFound, fail_msg || "Unable to locate '#{locator || kind_or_locator}'" unless node
|
||||||
|
return node
|
||||||
|
end
|
||||||
|
|
||||||
|
def find(*args)
|
||||||
|
all(*args).first
|
||||||
|
end
|
||||||
|
|
||||||
|
def find_field(locator)
|
||||||
|
find(:xpath, XPath.field(locator))
|
||||||
|
end
|
||||||
|
alias_method :field_labeled, :find_field
|
||||||
|
|
||||||
|
def find_link(locator)
|
||||||
|
find(:xpath, XPath.link(locator))
|
||||||
|
end
|
||||||
|
|
||||||
|
def find_button(locator)
|
||||||
|
find(:xpath, XPath.button(locator))
|
||||||
|
end
|
||||||
|
|
||||||
|
def find_by_id(id)
|
||||||
|
find(:css, "##{id}")
|
||||||
|
end
|
||||||
|
|
||||||
|
def all(*args)
|
||||||
|
options = if args.last.is_a?(Hash) then args.pop else {} end
|
||||||
|
|
||||||
|
results = XPath.wrap(normalize_locator(*args)).paths.map do |path|
|
||||||
|
base.find(path)
|
||||||
|
end.flatten
|
||||||
|
|
||||||
|
if options[:text]
|
||||||
|
|
||||||
|
if options[:text].kind_of?(Regexp)
|
||||||
|
regexp = options[:text]
|
||||||
|
else
|
||||||
|
regexp = Regexp.escape(options[:text])
|
||||||
|
end
|
||||||
|
|
||||||
|
results = results.select { |n| n.text.match(regexp) }
|
||||||
|
end
|
||||||
|
|
||||||
|
if options[:visible] or Capybara.ignore_hidden_elements
|
||||||
|
results = results.select { |n| n.visible? }
|
||||||
|
end
|
||||||
|
|
||||||
|
results.map { |n| Capybara::Element.new(self, n) }
|
||||||
|
end
|
||||||
|
|
||||||
|
protected
|
||||||
|
|
||||||
|
def normalize_locator(kind, locator=nil)
|
||||||
|
kind, locator = Capybara.default_selector, kind if locator.nil?
|
||||||
|
locator = XPath.from_css(locator) if kind == :css
|
||||||
|
locator
|
||||||
|
end
|
||||||
|
|
||||||
|
def wait_conditionally_until
|
||||||
|
if driver.wait? then wait_until { yield } else yield end
|
||||||
|
end
|
||||||
|
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
97
lib/capybara/node/matchers.rb
Normal file
97
lib/capybara/node/matchers.rb
Normal file
|
|
@ -0,0 +1,97 @@
|
||||||
|
module Capybara
|
||||||
|
class Node
|
||||||
|
module Matchers
|
||||||
|
def has_xpath?(path, options={})
|
||||||
|
wait_conditionally_until do
|
||||||
|
results = all(:xpath, path, options)
|
||||||
|
|
||||||
|
if options[:count]
|
||||||
|
results.size == options[:count]
|
||||||
|
else
|
||||||
|
results.size > 0
|
||||||
|
end
|
||||||
|
end
|
||||||
|
rescue Capybara::TimeoutError
|
||||||
|
return false
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_xpath?(path, options={})
|
||||||
|
wait_conditionally_until do
|
||||||
|
results = all(:xpath, path, options)
|
||||||
|
|
||||||
|
if options[:count]
|
||||||
|
results.size != options[:count]
|
||||||
|
else
|
||||||
|
results.empty?
|
||||||
|
end
|
||||||
|
end
|
||||||
|
rescue Capybara::TimeoutError
|
||||||
|
return false
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_css?(path, options={})
|
||||||
|
has_xpath?(XPath.from_css(path), options)
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_css?(path, options={})
|
||||||
|
has_no_xpath?(XPath.from_css(path), options)
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_content?(content)
|
||||||
|
has_xpath?(XPath.content(content))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_content?(content)
|
||||||
|
has_no_xpath?(XPath.content(content))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_link?(locator)
|
||||||
|
has_xpath?(XPath.link(locator))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_link?(locator)
|
||||||
|
has_no_xpath?(XPath.link(locator))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_button?(locator)
|
||||||
|
has_xpath?(XPath.button(locator))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_button?(locator)
|
||||||
|
has_no_xpath?(XPath.button(locator))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_field?(locator, options={})
|
||||||
|
has_xpath?(XPath.field(locator, options))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_field?(locator, options={})
|
||||||
|
has_no_xpath?(XPath.field(locator, options))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_checked_field?(locator)
|
||||||
|
has_xpath?(XPath.field(locator, :checked => true))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_unchecked_field?(locator)
|
||||||
|
has_xpath?(XPath.field(locator, :unchecked => true))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_select?(locator, options={})
|
||||||
|
has_xpath?(XPath.select(locator, options))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_select?(locator, options={})
|
||||||
|
has_no_xpath?(XPath.select(locator, options))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_table?(locator, options={})
|
||||||
|
has_xpath?(XPath.table(locator, options))
|
||||||
|
end
|
||||||
|
|
||||||
|
def has_no_table?(locator, options={})
|
||||||
|
has_no_xpath?(XPath.table(locator, options))
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
|
end
|
||||||
Loading…
Reference in a new issue