2010-08-27 18:37:39 +00:00
|
|
|
module Capybara
|
|
|
|
class Selector
|
2012-01-02 11:46:04 +00:00
|
|
|
attr_reader :name, :custom_filters
|
2010-08-27 18:37:39 +00:00
|
|
|
|
2011-02-10 15:59:26 +00:00
|
|
|
class Normalized
|
2012-01-02 11:53:03 +00:00
|
|
|
attr_accessor :selector, :locator, :options, :xpaths
|
2011-02-10 15:59:26 +00:00
|
|
|
|
|
|
|
def failure_message; selector.failure_message; end
|
|
|
|
def name; selector.name; end
|
2011-09-28 14:51:31 +00:00
|
|
|
|
|
|
|
def filter(node)
|
2012-01-02 11:53:03 +00:00
|
|
|
return false if options[:text] and not node.text.match(options[:text])
|
|
|
|
return false if options[:visible] and not node.visible?
|
|
|
|
return false if options[:with] and not node.value == options[:with]
|
|
|
|
return false if options[:checked] and not node.checked?
|
|
|
|
return false if options[:unchecked] and node.checked?
|
|
|
|
return false if options[:selected] and not has_selected_options?(node, options[:selected])
|
2012-01-02 11:46:04 +00:00
|
|
|
selector.custom_filters.each do |name, block|
|
|
|
|
return false if options.has_key?(name) and not block.call(node, options[name])
|
|
|
|
end
|
2011-09-28 14:51:31 +00:00
|
|
|
true
|
|
|
|
end
|
|
|
|
|
|
|
|
private
|
|
|
|
|
|
|
|
def has_selected_options?(node, expected)
|
|
|
|
actual = node.all(:xpath, './/option').select { |option| option.selected? }.map { |option| option.text }
|
|
|
|
(expected - actual).empty?
|
|
|
|
end
|
2011-02-10 15:59:26 +00:00
|
|
|
end
|
|
|
|
|
2010-08-27 18:37:39 +00:00
|
|
|
class << self
|
|
|
|
def all
|
|
|
|
@selectors ||= {}
|
|
|
|
end
|
|
|
|
|
2010-10-22 11:29:08 +00:00
|
|
|
def add(name, &block)
|
|
|
|
all[name.to_sym] = Capybara::Selector.new(name.to_sym, &block)
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
def remove(name)
|
|
|
|
all.delete(name.to_sym)
|
|
|
|
end
|
|
|
|
|
2011-02-06 19:07:12 +00:00
|
|
|
def normalize(*args)
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized = Normalized.new
|
|
|
|
normalized.options = if args.last.is_a?(Hash) then args.pop else {} end
|
2011-02-04 15:16:46 +00:00
|
|
|
|
2011-02-06 19:07:12 +00:00
|
|
|
if args[1]
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized.selector = all[args[0]]
|
|
|
|
normalized.locator = args[1]
|
2010-08-27 18:37:39 +00:00
|
|
|
else
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized.selector = all.values.find { |s| s.match?(args[0]) }
|
|
|
|
normalized.locator = args[0]
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized.selector ||= all[Capybara.default_selector]
|
2011-02-04 15:16:46 +00:00
|
|
|
|
2012-01-02 11:53:03 +00:00
|
|
|
xpath = normalized.selector.call(normalized.locator)
|
2010-10-06 19:07:26 +00:00
|
|
|
if xpath.respond_to?(:to_xpaths)
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized.xpaths = xpath.to_xpaths
|
2010-10-06 19:07:26 +00:00
|
|
|
else
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized.xpaths = [xpath.to_s].flatten
|
2010-10-06 19:07:26 +00:00
|
|
|
end
|
2011-02-10 15:59:26 +00:00
|
|
|
normalized
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2010-10-22 11:29:08 +00:00
|
|
|
def initialize(name, &block)
|
2010-08-27 18:37:39 +00:00
|
|
|
@name = name
|
2012-01-02 11:46:04 +00:00
|
|
|
@custom_filters = {}
|
2010-10-22 11:29:08 +00:00
|
|
|
instance_eval(&block)
|
|
|
|
end
|
|
|
|
|
|
|
|
def xpath(&block)
|
|
|
|
@xpath = block if block
|
|
|
|
@xpath
|
|
|
|
end
|
|
|
|
|
2011-09-29 20:04:51 +00:00
|
|
|
# Same as xpath, but wrap in XPath.css().
|
|
|
|
def css(&block)
|
|
|
|
if block
|
|
|
|
@xpath = xpath { |*args| XPath.css(block.call(*args)) }
|
|
|
|
end
|
|
|
|
@xpath
|
|
|
|
end
|
|
|
|
|
2010-10-22 11:29:08 +00:00
|
|
|
def match(&block)
|
|
|
|
@match = block if block
|
|
|
|
@match
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
|
|
|
|
2011-02-04 15:16:46 +00:00
|
|
|
def failure_message(&block)
|
|
|
|
@failure_message = block if block
|
|
|
|
@failure_message
|
|
|
|
end
|
|
|
|
|
2011-09-28 14:51:31 +00:00
|
|
|
def call(locator, xpath_options={})
|
|
|
|
@xpath.call(locator, xpath_options)
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
def match?(locator)
|
2010-10-22 11:29:08 +00:00
|
|
|
@match and @match.call(locator)
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
2012-01-02 11:46:04 +00:00
|
|
|
|
|
|
|
def filter(name, &block)
|
|
|
|
@custom_filters[name] = block
|
|
|
|
end
|
2010-08-27 18:37:39 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2010-10-22 11:29:08 +00:00
|
|
|
Capybara.add_selector(:xpath) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |xpath| xpath }
|
2010-10-22 11:29:08 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:css) do
|
2011-09-29 20:17:32 +00:00
|
|
|
css { |css| css }
|
2010-10-22 11:29:08 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:id) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |id| XPath.descendant[XPath.attr(:id) == id.to_s] }
|
2010-10-22 11:29:08 +00:00
|
|
|
match { |value| value.is_a?(Symbol) }
|
|
|
|
end
|
2011-08-27 02:16:15 +00:00
|
|
|
|
|
|
|
Capybara.add_selector(:field) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |locator| XPath::HTML.field(locator) }
|
2011-08-27 02:16:15 +00:00
|
|
|
end
|
|
|
|
|
2011-08-27 21:57:12 +00:00
|
|
|
Capybara.add_selector(:fieldset) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |locator| XPath::HTML.fieldset(locator) }
|
2011-08-27 21:57:12 +00:00
|
|
|
end
|
|
|
|
|
2011-08-27 02:16:15 +00:00
|
|
|
Capybara.add_selector(:link_or_button) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |locator| XPath::HTML.link_or_button(locator) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no link or button '#{selector.locator}' found" }
|
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:link) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.link(locator, xpath_options) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no link with title, id or text '#{selector.locator}' found" }
|
2012-01-02 11:53:03 +00:00
|
|
|
filter(:href) { |node, href| node[:href] == href }
|
2011-08-27 02:16:15 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:button) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |locator| XPath::HTML.button(locator) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no button with value or id or text '#{selector.locator}' found" }
|
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:fillable_field) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.fillable_field(locator, xpath_options) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no text field, text area or password field with id, name, or label '#{selector.locator}' found" }
|
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:radio_button) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.radio_button(locator, xpath_options) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no radio button with id, name, or label '#{selector.locator}' found" }
|
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:checkbox) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.checkbox(locator, xpath_options) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no checkbox with id, name, or label '#{selector.locator}' found" }
|
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:select) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.select(locator, xpath_options) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no select box with id, name, or label '#{selector.locator}' found" }
|
2012-01-02 11:53:03 +00:00
|
|
|
filter(:options) { |node, options| options.all? { |option| node.first(:option, option) } }
|
2011-08-27 02:16:15 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:option) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |locator| XPath::HTML.option(locator) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message do |node, selector|
|
|
|
|
"no option with text '#{selector.locator}'".tap do |message|
|
|
|
|
message << " in the select box" if node.tag_name == 'select'
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:file_field) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.file_field(locator, xpath_options) }
|
2011-08-27 02:16:15 +00:00
|
|
|
failure_message { |node, selector| "no file field with id, name, or label '#{selector.locator}' found" }
|
|
|
|
end
|
2011-08-27 21:54:55 +00:00
|
|
|
|
|
|
|
Capybara.add_selector(:content) do
|
2011-09-05 16:14:10 +00:00
|
|
|
xpath { |content| XPath::HTML.content(content) }
|
2011-08-27 21:54:55 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
Capybara.add_selector(:table) do
|
2011-09-28 14:51:31 +00:00
|
|
|
xpath { |locator, xpath_options| XPath::HTML.table(locator, xpath_options) }
|
2011-08-27 21:54:55 +00:00
|
|
|
end
|