2016-03-08 00:52:19 +00:00
# frozen_string_literal: true
2010-07-10 00:20:32 +00:00
module Capybara
2010-11-21 13:37:36 +00:00
module Node
2010-07-10 00:20:32 +00:00
module Matchers
2010-08-24 10:37:35 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Checks if a given selector is on the page or a descendant of the current node.
2010-08-24 10:37:35 +00:00
#
2010-10-12 11:26:24 +00:00
# page.has_selector?('p#foo')
# page.has_selector?(:xpath, './/p[@id="foo"]')
# page.has_selector?(:foo)
2010-08-24 10:37:35 +00:00
#
# By default it will check if the expression occurs at least once,
# but a different number can be specified.
#
2013-02-09 06:29:15 +00:00
# page.has_selector?('p.foo', :count => 4)
2010-08-24 10:37:35 +00:00
#
# This will check if the expression occurs exactly 4 times.
#
# It also accepts all options that {Capybara::Node::Finders#all} accepts,
# such as :text and :visible.
#
2010-10-12 11:26:24 +00:00
# page.has_selector?('li', :text => 'Horse', :visible => true)
2010-08-24 10:37:35 +00:00
#
2010-10-12 11:26:24 +00:00
# has_selector? can also accept XPath expressions generated by the
2010-08-24 10:37:35 +00:00
# XPath gem:
#
2012-07-13 18:33:14 +00:00
# page.has_selector?(:xpath, XPath.descendant(:p))
2010-08-24 10:37:35 +00:00
#
2010-10-12 11:26:24 +00:00
# @param (see Capybara::Node::Finders#all)
2013-03-29 02:15:07 +00:00
# @param args
# @option args [Integer] :count (nil) Number of times the text should occur
# @option args [Integer] :minimum (nil) Minimum number of times the text should occur
# @option args [Integer] :maximum (nil) Maximum number of times the text should occur
# @option args [Range] :between (nil) Range of times that should contain number of times text occurs
# @return [Boolean] If the expression exists
2010-08-24 10:37:35 +00:00
#
2010-10-12 11:26:24 +00:00
def has_selector? ( * args )
2012-07-09 11:39:57 +00:00
assert_selector ( * args )
2011-08-12 12:38:42 +00:00
rescue Capybara :: ExpectationNotMet
2010-07-10 00:20:32 +00:00
return false
end
2012-07-13 18:34:56 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Checks if a given selector is not on the page or a descendant of thecurrent node.
2012-07-13 18:34:56 +00:00
# Usage is identical to Capybara::Node::Matchers#has_selector?
#
# @param (see Capybara::Node::Finders#has_selector?)
# @return [Boolean]
#
def has_no_selector? ( * args )
assert_no_selector ( * args )
rescue Capybara :: ExpectationNotMet
return false
end
2016-01-30 00:31:35 +00:00
##
#
# Checks if the current node matches given selector
#
# @param (see Capybara::Node::Finders#has_selector?)
# @return [Boolean]
#
2016-03-18 22:17:16 +00:00
def matches_selector? ( * args )
assert_matches_selector ( * args )
2016-01-30 00:31:35 +00:00
rescue Capybara :: ExpectationNotMet
return false
end
2016-09-13 18:09:47 +00:00
##
#
# Checks if the current node matches given XPath expression
#
# @param [String, XPath::Expression] xpath The XPath expression to match against the current code
# @return [Boolean]
#
def matches_xpath? ( xpath , options = { } )
matches_selector? ( :xpath , xpath , options )
end
##
#
# Checks if the current node matches given CSS selector
#
# @param [String] css The CSS selector to match against the current code
# @return [Boolean]
#
def matches_css? ( css , options = { } )
matches_selector? ( :css , css , options )
end
2016-01-30 00:31:35 +00:00
##
#
# Checks if the current node does not match given selector
# Usage is identical to Capybara::Node::Matchers#has_selector?
#
# @param (see Capybara::Node::Finders#has_selector?)
# @return [Boolean]
#
2016-03-18 22:17:16 +00:00
def not_matches_selector? ( * args )
assert_not_matches_selector ( * args )
2016-01-30 00:31:35 +00:00
rescue Capybara :: ExpectationNotMet
return false
end
2016-09-13 18:09:47 +00:00
##
#
# Checks if the current node does not match given XPath expression
#
# @param [String, XPath::Expression] xpath The XPath expression to match against the current code
# @return [Boolean]
#
def not_matches_xpath? ( xpath , options = { } )
not_matches_selector? ( :xpath , xpath , options )
end
##
#
# Checks if the current node does not match given CSS selector
#
# @param [String] css The CSS selector to match against the current code
# @return [Boolean]
#
def not_matches_css? ( css , options = { } )
not_matches_selector? ( :css , css , options )
end
2016-01-30 00:31:35 +00:00
2012-07-13 18:33:14 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Asserts that a given selector is on the page or a descendant of the current node.
2012-07-13 18:33:14 +00:00
#
# page.assert_selector('p#foo')
# page.assert_selector(:xpath, './/p[@id="foo"]')
# page.assert_selector(:foo)
#
# By default it will check if the expression occurs at least once,
# but a different number can be specified.
#
# page.assert_selector('p#foo', :count => 4)
#
2014-01-17 19:00:45 +00:00
# This will check if the expression occurs exactly 4 times. See
# {Capybara::Node::Finders#all} for other available result size options.
#
# If a :count of 0 is specified, it will behave like {#assert_no_selector};
# however, use of that method is preferred over this one.
2012-07-13 18:33:14 +00:00
#
# It also accepts all options that {Capybara::Node::Finders#all} accepts,
# such as :text and :visible.
#
# page.assert_selector('li', :text => 'Horse', :visible => true)
#
2013-03-04 21:35:11 +00:00
# `assert_selector` can also accept XPath expressions generated by the
2012-07-13 18:33:14 +00:00
# XPath gem:
#
# page.assert_selector(:xpath, XPath.descendant(:p))
#
# @param (see Capybara::Node::Finders#all)
# @option options [Integer] :count (nil) Number of times the expression should occur
# @raise [Capybara::ExpectationNotMet] If the selector does not exist
#
2012-07-09 11:39:57 +00:00
def assert_selector ( * args )
2016-01-30 00:31:35 +00:00
query = Capybara :: Queries :: SelectorQuery . new ( * args )
2013-07-03 12:05:45 +00:00
synchronize ( query . wait ) do
2014-02-16 17:13:58 +00:00
result = query . resolve_for ( self )
2016-08-30 18:37:54 +00:00
unless result . matches_count? && ( ( ! result . empty? ) || query . expects_none? )
2014-02-16 17:13:58 +00:00
raise Capybara :: ExpectationNotMet , result . failure_message
end
2012-06-08 14:47:01 +00:00
end
return true
end
2012-07-13 18:33:14 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Asserts that a given selector is not on the page or a descendant of the current node.
2012-07-13 18:33:14 +00:00
# Usage is identical to Capybara::Node::Matchers#assert_selector
#
2014-01-17 19:00:45 +00:00
# Query options such as :count, :minimum, :maximum, and :between are
# considered to be an integral part of the selector. This will return
# true, for example, if a page contains 4 anchors but the query expects 5:
#
# page.assert_no_selector('a', :minimum => 1) # Found, raises Capybara::ExpectationNotMet
# page.assert_no_selector('a', :count => 4) # Found, raises Capybara::ExpectationNotMet
# page.assert_no_selector('a', :count => 5) # Not Found, returns true
#
2012-07-13 18:33:14 +00:00
# @param (see Capybara::Node::Finders#assert_selector)
# @raise [Capybara::ExpectationNotMet] If the selector exists
#
2012-07-09 11:39:57 +00:00
def assert_no_selector ( * args )
2016-01-30 00:31:35 +00:00
query = Capybara :: Queries :: SelectorQuery . new ( * args )
2013-07-03 12:05:45 +00:00
synchronize ( query . wait ) do
2014-02-16 17:13:58 +00:00
result = query . resolve_for ( self )
2016-08-30 18:37:54 +00:00
if result . matches_count? && ( ( ! result . empty? ) || query . expects_none? )
2014-02-16 17:13:58 +00:00
raise Capybara :: ExpectationNotMet , result . negative_failure_message
2014-01-17 19:00:45 +00:00
end
2012-06-08 14:47:01 +00:00
end
return true
end
2014-01-29 11:45:18 +00:00
alias_method :refute_selector , :assert_no_selector
2016-01-30 00:31:35 +00:00
##
#
# Asserts that the current_node matches a given selector
#
2016-03-18 22:17:16 +00:00
# node.assert_matches_selector('p#foo')
# node.assert_matches_selector(:xpath, '//p[@id="foo"]')
# node.assert_matches_selector(:foo)
2016-01-30 00:31:35 +00:00
#
# It also accepts all options that {Capybara::Node::Finders#all} accepts,
# such as :text and :visible.
#
2016-03-18 22:17:16 +00:00
# node.assert_matches_selector('li', :text => 'Horse', :visible => true)
2016-01-30 00:31:35 +00:00
#
# @param (see Capybara::Node::Finders#all)
# @raise [Capybara::ExpectationNotMet] If the selector does not match
#
2016-03-18 22:17:16 +00:00
def assert_matches_selector ( * args )
2016-01-30 00:31:35 +00:00
query = Capybara :: Queries :: MatchQuery . new ( * args )
synchronize ( query . wait ) do
2016-07-18 21:16:22 +00:00
result = query . resolve_for ( self . query_scope )
2016-01-30 00:31:35 +00:00
unless result . include? self
raise Capybara :: ExpectationNotMet , " Item does not match the provided selector "
end
end
return true
end
2016-03-18 22:17:16 +00:00
def assert_not_matches_selector ( * args )
2016-01-30 00:31:35 +00:00
query = Capybara :: Queries :: MatchQuery . new ( * args )
synchronize ( query . wait ) do
2016-07-18 21:16:22 +00:00
result = query . resolve_for ( self . query_scope )
2016-01-30 00:31:35 +00:00
if result . include? self
raise Capybara :: ExpectationNotMet , 'Item matched the provided selector'
end
end
return true
end
2016-03-18 22:17:16 +00:00
alias_method :refute_matches_selector , :assert_not_matches_selector
2016-01-30 00:31:35 +00:00
2010-10-12 11:26:24 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Checks if a given XPath expression is on the page or a descendant of the current node.
2010-10-12 11:26:24 +00:00
#
# page.has_xpath?('.//p[@id="foo"]')
#
# By default it will check if the expression occurs at least once,
# but a different number can be specified.
#
# page.has_xpath?('.//p[@id="foo"]', :count => 4)
#
# This will check if the expression occurs exactly 4 times.
#
# It also accepts all options that {Capybara::Node::Finders#all} accepts,
# such as :text and :visible.
#
# page.has_xpath?('.//li', :text => 'Horse', :visible => true)
#
# has_xpath? can also accept XPath expressions generate by the
# XPath gem:
#
# xpath = XPath.generate { |x| x.descendant(:p) }
# page.has_xpath?(xpath)
#
# @param [String] path An XPath expression
# @param options (see Capybara::Node::Finders#all)
# @option options [Integer] :count (nil) Number of times the expression should occur
# @return [Boolean] If the expression exists
#
def has_xpath? ( path , options = { } )
has_selector? ( :xpath , path , options )
end
##
#
2016-09-16 17:50:49 +00:00
# Checks if a given XPath expression is not on the page or a descendant of the current node.
2010-10-12 11:26:24 +00:00
# Usage is identical to Capybara::Node::Matchers#has_xpath?
#
# @param (see Capybara::Node::Finders#has_xpath?)
# @return [Boolean]
#
def has_no_xpath? ( path , options = { } )
has_no_selector? ( :xpath , path , options )
end
2010-08-24 10:37:35 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Checks if a given CSS selector is on the page or a descendant of the current node.
2010-08-24 10:37:35 +00:00
#
# page.has_css?('p#foo')
#
# By default it will check if the selector occurs at least once,
# but a different number can be specified.
#
# page.has_css?('p#foo', :count => 4)
#
# This will check if the selector occurs exactly 4 times.
#
# It also accepts all options that {Capybara::Node::Finders#all} accepts,
# such as :text and :visible.
#
# page.has_css?('li', :text => 'Horse', :visible => true)
#
# @param [String] path A CSS selector
# @param options (see Capybara::Node::Finders#all)
# @option options [Integer] :count (nil) Number of times the selector should occur
# @return [Boolean] If the selector exists
#
2010-07-10 00:20:32 +00:00
def has_css? ( path , options = { } )
2011-08-27 21:54:55 +00:00
has_selector? ( :css , path , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
2016-09-16 17:50:49 +00:00
# Checks if a given CSS selector is not on the page or a descendant of the current node.
2010-08-24 10:37:35 +00:00
# Usage is identical to Capybara::Node::Matchers#has_css?
#
# @param (see Capybara::Node::Finders#has_css?)
# @return [Boolean]
#
2010-07-10 00:20:32 +00:00
def has_no_css? ( path , options = { } )
2011-08-27 21:54:55 +00:00
has_no_selector? ( :css , path , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a link with the given
# text or id.
#
2010-11-18 23:08:26 +00:00
# @param [String] locator The text or id of a link to check for
# @param options
2015-04-28 00:33:39 +00:00
# @option options [String, Regexp] :href The value the href attribute must be
2010-11-18 23:08:26 +00:00
# @return [Boolean] Whether it exists
2010-08-24 10:37:35 +00:00
#
2010-11-18 23:08:26 +00:00
def has_link? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_selector? ( :link , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has no link with the given
# text or id.
#
2010-11-18 23:08:26 +00:00
# @param (see Capybara::Node::Finders#has_link?)
2010-08-24 10:37:35 +00:00
# @return [Boolean] Whether it doesn't exist
#
2010-11-18 23:08:26 +00:00
def has_no_link? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_no_selector? ( :link , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a button with the given
# text, value or id.
#
# @param [String] locator The text, value or id of a button to check for
# @return [Boolean] Whether it exists
#
2013-08-08 23:05:38 +00:00
def has_button? ( locator , options = { } )
has_selector? ( :button , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has no button with the given
# text, value or id.
#
# @param [String] locator The text, value or id of a button to check for
# @return [Boolean] Whether it doesn't exist
#
2013-08-08 23:05:38 +00:00
def has_no_button? ( locator , options = { } )
has_no_selector? ( :button , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a form field with the given
# label, name or id.
#
# For text fields and other textual fields, such as textareas and
# HTML5 email/url/etc. fields, it's possible to specify a :with
# option to specify the text the field should contain:
#
# page.has_field?('Name', :with => 'Jonas')
#
2012-03-01 02:57:05 +00:00
# It is also possible to filter by the field type attribute:
#
# page.has_field?('Email', :type => 'email')
#
2013-03-07 17:59:16 +00:00
# Note: 'textarea' and 'select' are valid type values, matching the associated tag names.
#
2016-07-28 08:25:24 +00:00
# @param [String] locator The label, name or id of a field to check for
# @option options [String, Regexp] :with The text content of the field or a Regexp to match
# @option options [String] :type The type attribute of the field
# @return [Boolean] Whether it exists
2010-08-24 10:37:35 +00:00
#
2010-07-10 00:20:32 +00:00
def has_field? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_selector? ( :field , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has no form field with the given
# label, name or id. See {Capybara::Node::Matchers#has_field?}.
#
2016-07-28 08:25:24 +00:00
# @param [String] locator The label, name or id of a field to check for
# @option options [String, Regexp] :with The text content of the field or a Regexp to match
# @option options [String] :type The type attribute of the field
# @return [Boolean] Whether it doesn't exist
2010-08-24 10:37:35 +00:00
#
2010-07-10 00:20:32 +00:00
def has_no_field? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_no_selector? ( :field , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a radio button or
# checkbox with the given label, value or id, that is currently
# checked.
#
# @param [String] locator The label, name or id of a checked field
# @return [Boolean] Whether it exists
#
2013-08-09 01:36:33 +00:00
def has_checked_field? ( locator , options = { } )
has_selector? ( :field , locator , options . merge ( :checked = > true ) )
2010-07-10 00:20:32 +00:00
end
2011-03-25 10:35:59 +00:00
##
#
# Checks if the page or current node has no radio button or
# checkbox with the given label, value or id, that is currently
# checked.
#
# @param [String] locator The label, name or id of a checked field
2013-07-23 21:24:44 +00:00
# @return [Boolean] Whether it doesn't exist
2011-03-25 10:35:59 +00:00
#
2013-08-09 01:36:33 +00:00
def has_no_checked_field? ( locator , options = { } )
has_no_selector? ( :field , locator , options . merge ( :checked = > true ) )
2011-03-25 10:35:59 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a radio button or
# checkbox with the given label, value or id, that is currently
# unchecked.
#
# @param [String] locator The label, name or id of an unchecked field
# @return [Boolean] Whether it exists
#
2013-08-09 01:36:33 +00:00
def has_unchecked_field? ( locator , options = { } )
has_selector? ( :field , locator , options . merge ( :unchecked = > true ) )
2010-07-10 00:20:32 +00:00
end
2011-03-25 10:35:59 +00:00
##
#
# Checks if the page or current node has no radio button or
# checkbox with the given label, value or id, that is currently
# unchecked.
#
# @param [String] locator The label, name or id of an unchecked field
2013-07-23 21:24:44 +00:00
# @return [Boolean] Whether it doesn't exist
2011-03-25 10:35:59 +00:00
#
2013-08-09 01:36:33 +00:00
def has_no_unchecked_field? ( locator , options = { } )
has_no_selector? ( :field , locator , options . merge ( :unchecked = > true ) )
2011-03-25 10:35:59 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a select field with the
# given label, name or id.
#
# It can be specified which option should currently be selected:
#
# page.has_select?('Language', :selected => 'German')
#
# For multiple select boxes, several options may be specified:
#
# page.has_select?('Language', :selected => ['English', 'German'])
#
2012-03-16 03:14:47 +00:00
# It's also possible to check if the exact set of options exists for
2010-08-24 10:37:35 +00:00
# this select box:
#
2012-03-23 01:24:49 +00:00
# page.has_select?('Language', :options => ['English', 'German', 'Spanish'])
#
# You can also check for a partial set of options:
#
# page.has_select?('Language', :with_options => ['English', 'German'])
2010-08-24 10:37:35 +00:00
#
# @param [String] locator The label, name or id of a select box
# @option options [Array] :options Options which should be contained in this select box
2012-03-23 01:24:49 +00:00
# @option options [Array] :with_options Partial set of options which should be contained in this select box
2010-08-24 10:37:35 +00:00
# @option options [String, Array] :selected Options which should be selected
# @return [Boolean] Whether it exists
#
2010-07-10 00:20:32 +00:00
def has_select? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_selector? ( :select , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has no select field with the
# given label, name or id. See {Capybara::Node::Matchers#has_select?}.
#
# @param (see Capybara::Node::Matchers#has_select?)
# @return [Boolean] Whether it doesn't exist
#
2010-07-10 00:20:32 +00:00
def has_no_select? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_no_selector? ( :select , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has a table with the given id
2012-12-23 15:11:33 +00:00
# or caption:
2010-08-24 10:37:35 +00:00
#
2012-12-23 15:11:33 +00:00
# page.has_table?('People')
2010-08-24 10:37:35 +00:00
#
# @param [String] locator The id or caption of a table
# @return [Boolean] Whether it exist
#
2010-07-10 00:20:32 +00:00
def has_table? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_selector? ( :table , locator , options )
2010-07-10 00:20:32 +00:00
end
2010-08-24 10:37:35 +00:00
##
#
# Checks if the page or current node has no table with the given id
2010-08-27 18:52:06 +00:00
# or caption. See {Capybara::Node::Matchers#has_table?}.
2010-08-24 10:37:35 +00:00
#
# @param (see Capybara::Node::Matchers#has_table?)
# @return [Boolean] Whether it doesn't exist
#
2010-07-10 00:20:32 +00:00
def has_no_table? ( locator , options = { } )
2011-08-27 21:54:55 +00:00
has_no_selector? ( :table , locator , options )
2010-12-23 18:38:44 +00:00
end
2011-10-16 23:46:19 +00:00
2014-02-16 17:13:58 +00:00
##
# Asserts that the page or current node has the given text content,
# ignoring any HTML tags.
#
# @!macro text_query_params
# @overload $0(type, text, options = {})
2015-11-02 16:04:20 +00:00
# @param [:all, :visible] type Whether to check for only visible or all text. If this parameter is missing or nil then we use the value of `Capybara.ignore_hidden_elements`, which defaults to `true`, corresponding to `:visible`.
2014-02-16 17:13:58 +00:00
# @param [String, Regexp] text The string/regexp to check for. If it's a string, text is expected to include it. If it's a regexp, text is expected to match it.
# @option options [Integer] :count (nil) Number of times the text is expected to occur
# @option options [Integer] :minimum (nil) Minimum number of times the text is expected to occur
# @option options [Integer] :maximum (nil) Maximum number of times the text is expected to occur
# @option options [Range] :between (nil) Range of times that is expected to contain number of times text occurs
2015-04-14 20:56:30 +00:00
# @option options [Numeric] :wait (Capybara.default_max_wait_time) Maximum time that Capybara will wait for text to eq/match given string/regexp argument
2014-02-16 17:13:58 +00:00
# @overload $0(text, options = {})
# @param [String, Regexp] text The string/regexp to check for. If it's a string, text is expected to include it. If it's a regexp, text is expected to match it.
# @option options [Integer] :count (nil) Number of times the text is expected to occur
# @option options [Integer] :minimum (nil) Minimum number of times the text is expected to occur
# @option options [Integer] :maximum (nil) Maximum number of times the text is expected to occur
# @option options [Range] :between (nil) Range of times that is expected to contain number of times text occurs
2015-04-14 20:56:30 +00:00
# @option options [Numeric] :wait (Capybara.default_max_wait_time) Maximum time that Capybara will wait for text to eq/match given string/regexp argument
2014-02-16 17:13:58 +00:00
# @raise [Capybara::ExpectationNotMet] if the assertion hasn't succeeded during wait time
# @return [true]
#
def assert_text ( * args )
query = Capybara :: Queries :: TextQuery . new ( * args )
synchronize ( query . wait ) do
count = query . resolve_for ( self )
2016-08-30 18:37:54 +00:00
unless query . matches_count? ( count ) && ( ( count > 0 ) || query . expects_none? )
2014-02-16 17:13:58 +00:00
raise Capybara :: ExpectationNotMet , query . failure_message
end
end
return true
2012-07-12 15:12:24 +00:00
end
2014-02-16 17:13:58 +00:00
##
# Asserts that the page or current node doesn't have the given text content,
# ignoring any HTML tags.
#
# @macro text_query_params
# @raise [Capybara::ExpectationNotMet] if the assertion hasn't succeeded during wait time
# @return [true]
#
def assert_no_text ( * args )
query = Capybara :: Queries :: TextQuery . new ( * args )
synchronize ( query . wait ) do
count = query . resolve_for ( self )
2016-08-30 18:37:54 +00:00
if query . matches_count? ( count ) && ( ( count > 0 ) || query . expects_none? )
2014-02-16 17:13:58 +00:00
raise Capybara :: ExpectationNotMet , query . negative_failure_message
end
end
return true
end
2012-01-02 11:17:15 +00:00
2014-02-16 17:13:58 +00:00
##
# Checks if the page or current node has the given text content,
# ignoring any HTML tags.
#
# Whitespaces are normalized in both node's text and passed text parameter.
# Note that whitespace isn't normalized in passed regexp as normalizing whitespace
# in regexp isn't easy and doesn't seem to be worth it.
#
# By default it will check if the text occurs at least once,
# but a different number can be specified.
#
# page.has_text?('lorem ipsum', between: 2..4)
#
# This will check if the text occurs from 2 to 4 times.
#
# @macro text_query_params
# @return [Boolean] Whether it exists
#
def has_text? ( * args )
assert_text ( * args )
rescue Capybara :: ExpectationNotMet
return false
end
alias_method :has_content? , :has_text?
2013-03-17 14:48:04 +00:00
2014-02-16 17:13:58 +00:00
##
# Checks if the page or current node does not have the given text
# content, ignoring any HTML tags and normalizing whitespace.
#
# @macro text_query_params
# @return [Boolean] Whether it doesn't exist
#
def has_no_text? ( * args )
assert_no_text ( * args )
rescue Capybara :: ExpectationNotMet
return false
end
alias_method :has_no_content? , :has_no_text?
def == ( other )
self . eql? ( other ) || ( other . respond_to? ( :base ) && base == other . base )
2013-03-03 23:04:23 +00:00
end
2010-07-10 00:20:32 +00:00
end
end
end