Module: Capybara::Node::Matchers
Instance Method Summary collapse
- #==(other) ⇒ Object
-
#assert_all_of_selectors([kind = Capybara.default_selector], *locators, **options) ⇒ Object
Asserts that all of the provided selectors are present on the given page or descendants of the current node.
-
#assert_ancestor(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector matches an ancestor of the current node.
-
#assert_any_of_selectors([kind = Capybara.default_selector], *locators, **options) ⇒ Object
Asserts that any of the provided selectors are present on the given page or descendants of the current node.
-
#assert_matches_selector(*args, &optional_filter_block) ⇒ Object
Asserts that the current node matches a given selector.
-
#assert_matches_style(styles = nil, **options) ⇒ Object
Asserts that an element has the specified CSS styles.
- #assert_no_ancestor(*args, &optional_filter_block) ⇒ Object
-
#assert_no_selector(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector is not on the page or a descendant of the current node.
- #assert_no_sibling(*args, &optional_filter_block) ⇒ Object
-
#assert_no_text(type_or_text, *args, **opts) ⇒ true
Asserts that the page or current node doesn't have the given text content, ignoring any HTML tags.
-
#assert_none_of_selectors([kind = Capybara.default_selector], *locators, **options) ⇒ Object
Asserts that none of the provided selectors are present on the given page or descendants of the current node.
-
#assert_not_matches_selector(*args, &optional_filter_block) ⇒ Object
Asserts that the current node does not match a given selector.
-
#assert_selector(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector is on the page or a descendant of the current node.
-
#assert_sibling(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector matches a sibling of the current node.
-
#assert_style(styles = nil, **options) ⇒ Object
deprecated
Deprecated.
Use #assert_matches_style instead.
-
#assert_text(type_or_text, *args, **opts) ⇒ true
Asserts that the page or current node has the given text content, ignoring any HTML tags.
-
#has_ancestor?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_ancestor.
-
#has_button?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a button with the given text, value or id.
-
#has_checked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a radio button or checkbox with the given label, value, id, or test_id attribute that is currently checked.
-
#has_css?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given CSS selector is on the page or a descendant of the current node.
-
#has_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a form field with the given label, name or id.
-
#has_link?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a link with the given text or id.
-
#has_no_ancestor?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_no_ancestor.
-
#has_no_button?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no button with the given text, value or id.
-
#has_no_checked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no radio button or checkbox with the given label, value or id, or test_id attribute that is currently checked.
-
#has_no_css?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given CSS selector is not on the page or a descendant of the current node.
-
#has_no_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no form field with the given label, name or id.
-
#has_no_link?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no link with the given text or id.
-
#has_no_select?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no select field with the given label, name or id.
-
#has_no_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if a given selector is not on the page or a descendant of the current node.
-
#has_no_sibling?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_no_sibling.
-
#has_no_table?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no table with the given id or caption.
-
#has_no_text?(*args, **options) ⇒ Boolean
(also: #has_no_content?)
Checks if the page or current node does not have the given text content, ignoring any HTML tags and normalizing whitespace.
-
#has_no_unchecked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no radio button or checkbox with the given label, value or id, or test_id attribute that is currently unchecked.
-
#has_no_xpath?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given XPath expression is not on the page or a descendant of the current node.
-
#has_select?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a select field with the given label, name or id.
-
#has_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if a given selector is on the page or a descendant of the current node.
-
#has_sibling?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_sibling.
-
#has_style?(styles = nil, **options) ⇒ Boolean
deprecated
Deprecated.
Use #matches_style? instead.
-
#has_table?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a table with the given id or caption:.
-
#has_text?(*args, **options) ⇒ Boolean
(also: #has_content?)
Checks if the page or current node has the given text content, ignoring any HTML tags.
-
#has_unchecked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a radio button or checkbox with the given label, value or id, or test_id attribute that is currently unchecked.
-
#has_xpath?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given XPath expression is on the page or a descendant of the current node.
-
#matches_css?(css, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node matches given CSS selector.
-
#matches_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node matches given selector.
-
#matches_style?(styles = nil, **options) ⇒ Boolean
Checks if a an element has the specified CSS styles.
-
#matches_xpath?(xpath, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node matches given XPath expression.
-
#not_matches_css?(css, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node does not match given CSS selector.
-
#not_matches_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node does not match given selector.
-
#not_matches_xpath?(xpath, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node does not match given XPath expression.
Instance Method Details
#==(other) ⇒ Object
816 817 818 |
# File 'lib/capybara/node/matchers.rb', line 816 def ==(other) eql?(other) || (other.respond_to?(:base) && base == other.base) end |
#assert_all_of_selectors([kind = Capybara.default_selector], *locators, **options) ⇒ Object
Asserts that all of the provided selectors are present on the given page
or descendants of the current node. If options are provided, the assertion
will check that each locator is present with those options as well (other than :wait
).
page.assert_all_of_selectors(:custom, 'Tom', 'Joe', visible: all)
page.assert_all_of_selectors(:css, '#my_div', 'a.not_clicked')
It accepts all options that Finders#all accepts,
such as :text
and :visible
.
The :wait
option applies to all of the selectors as a group, so all of the locators must be present
within :wait
(defaults to default_max_wait_time) seconds.
159 160 161 162 163 |
# File 'lib/capybara/node/matchers.rb', line 159 def assert_all_of_selectors(*args, **, &optional_filter_block) _verify_multiple(*args, **) do |selector, locator, opts| assert_selector(selector, locator, opts, &optional_filter_block) end end |
#assert_ancestor(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector matches an ancestor of the current node.
element.assert_ancestor('p#foo')
Accepts the same options as #assert_selector
741 742 743 744 745 746 747 |
# File 'lib/capybara/node/matchers.rb', line 741 def assert_ancestor(*args, &optional_filter_block) _verify_selector_result(args, optional_filter_block, Capybara::Queries::AncestorQuery) do |result, query| unless result.matches_count? && (result.any? || query.expects_none?) raise Capybara::ExpectationNotMet, result. end end end |
#assert_any_of_selectors([kind = Capybara.default_selector], *locators, **options) ⇒ Object
Asserts that any of the provided selectors are present on the given page
or descendants of the current node. If options are provided, the assertion
will check that each locator is present with those options as well (other than :wait
).
page.assert_any_of_selectors(:custom, 'Tom', 'Joe', visible: all)
page.assert_any_of_selectors(:css, '#my_div', 'a.not_clicked')
It accepts all options that Finders#all accepts,
such as :text
and :visible
.
The :wait
option applies to all of the selectors as a group, so any of the locators must be present
within :wait
(defaults to default_max_wait_time) seconds.
201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 |
# File 'lib/capybara/node/matchers.rb', line 201 def assert_any_of_selectors(*args, wait: nil, **, &optional_filter_block) wait = .default_max_wait_time if wait.nil? selector = extract_selector(args) synchronize(wait) do res = args.map do |locator| assert_selector(selector, locator, , &optional_filter_block) break nil rescue Capybara::ExpectationNotMet => e e. end raise Capybara::ExpectationNotMet, res.join(' or ') if res true end end |
#assert_matches_selector(*args, &optional_filter_block) ⇒ Object
Asserts that the current node matches a given selector.
node.assert_matches_selector('p#foo')
node.assert_matches_selector(:xpath, '//p[@id="foo"]')
node.assert_matches_selector(:foo)
It also accepts all options that Finders#all accepts,
such as :text
and :visible
.
node.assert_matches_selector('li', text: 'Horse', visible: true)
561 562 563 564 565 |
# File 'lib/capybara/node/matchers.rb', line 561 def assert_matches_selector(*args, &optional_filter_block) _verify_match_result(args, optional_filter_block) do |result| raise Capybara::ExpectationNotMet, 'Item does not match the provided selector' unless result.include? self end end |
#assert_matches_style(styles = nil, **options) ⇒ Object
Asserts that an element has the specified CSS styles.
element.assert_matches_style( 'color' => 'rgb(0,0,255)', 'font-size' => /px/ )
126 127 128 129 130 131 132 133 134 |
# File 'lib/capybara/node/matchers.rb', line 126 def assert_matches_style(styles = nil, **) styles, = , {} if styles.nil? query_args, query_opts = (styles, ) query = Capybara::Queries::StyleQuery.new(*query_args, **query_opts) synchronize(query.wait) do raise Capybara::ExpectationNotMet, query. unless query.resolves_for?(self) end true end |
#assert_no_ancestor(*args, &optional_filter_block) ⇒ Object
749 750 751 752 753 754 755 |
# File 'lib/capybara/node/matchers.rb', line 749 def assert_no_ancestor(*args, &optional_filter_block) _verify_selector_result(args, optional_filter_block, Capybara::Queries::AncestorQuery) do |result, query| if result.matches_count? && (!result.empty? || query.expects_none?) raise Capybara::ExpectationNotMet, result. end end end |
#assert_no_selector(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector is not on the page or a descendant of the current node. Usage is identical to #assert_selector.
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
233 234 235 236 237 238 239 |
# File 'lib/capybara/node/matchers.rb', line 233 def assert_no_selector(*args, &optional_filter_block) _verify_selector_result(args, optional_filter_block) do |result, query| if result.matches_count? && (!result.empty? || query.expects_none?) raise Capybara::ExpectationNotMet, result. end end end |
#assert_no_sibling(*args, &optional_filter_block) ⇒ Object
792 793 794 795 796 797 798 |
# File 'lib/capybara/node/matchers.rb', line 792 def assert_no_sibling(*args, &optional_filter_block) _verify_selector_result(args, optional_filter_block, Capybara::Queries::SiblingQuery) do |result, query| if result.matches_count? && (!result.empty? || query.expects_none?) raise Capybara::ExpectationNotMet, result. end end end |
#assert_no_text(type, text, **options) ⇒ true #assert_no_text(text, **options) ⇒ true
Asserts that the page or current node doesn't have the given text content, ignoring any HTML tags.
691 692 693 694 695 696 697 |
# File 'lib/capybara/node/matchers.rb', line 691 def assert_no_text(type_or_text, *args, **opts) _verify_text(type_or_text, *args, **opts) do |count, query| if query.matches_count?(count) && (count.positive? || query.expects_none?) raise Capybara::ExpectationNotMet, query. end end end |
#assert_none_of_selectors([kind = Capybara.default_selector], *locators, **options) ⇒ Object
Asserts that none of the provided selectors are present on the given page
or descendants of the current node. If options are provided, the assertion
will check that each locator is not present with those options as well (other than :wait
).
page.assert_none_of_selectors(:custom, 'Tom', 'Joe', visible: all)
page.assert_none_of_selectors(:css, '#my_div', 'a.not_clicked')
It accepts all options that Finders#all accepts,
such as :text
and :visible
.
The :wait
option applies to all of the selectors as a group, so none of the locators must be present
within :wait
(defaults to default_max_wait_time) seconds.
180 181 182 183 184 |
# File 'lib/capybara/node/matchers.rb', line 180 def assert_none_of_selectors(*args, **, &optional_filter_block) _verify_multiple(*args, **) do |selector, locator, opts| assert_no_selector(selector, locator, opts, &optional_filter_block) end end |
#assert_not_matches_selector(*args, &optional_filter_block) ⇒ Object
Asserts that the current node does not match a given selector. Usage is identical to #assert_matches_selector.
575 576 577 578 579 |
# File 'lib/capybara/node/matchers.rb', line 575 def assert_not_matches_selector(*args, &optional_filter_block) _verify_match_result(args, optional_filter_block) do |result| raise Capybara::ExpectationNotMet, 'Item matched the provided selector' if result.include? self end end |
#assert_selector(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector is on the page or a descendant of the current node.
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)
This will check if the expression occurs exactly 4 times. See 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.
It also accepts all options that Finders#all accepts,
such as :text
and :visible
.
page.assert_selector('li', text: 'Horse', visible: true)
#assert_selector can also accept XPath expressions generated by the XPath gem:
page.assert_selector(:xpath, XPath.descendant(:p))
109 110 111 112 113 114 115 |
# File 'lib/capybara/node/matchers.rb', line 109 def assert_selector(*args, &optional_filter_block) _verify_selector_result(args, optional_filter_block) do |result, query| unless result.matches_count? && (result.any? || query.expects_none?) raise Capybara::ExpectationNotMet, result. end end end |
#assert_sibling(*args, &optional_filter_block) ⇒ Object
Asserts that a given selector matches a sibling of the current node.
element.assert_sibling('p#foo')
Accepts the same options as #assert_selector
784 785 786 787 788 789 790 |
# File 'lib/capybara/node/matchers.rb', line 784 def assert_sibling(*args, &optional_filter_block) _verify_selector_result(args, optional_filter_block, Capybara::Queries::SiblingQuery) do |result, query| unless result.matches_count? && (result.any? || query.expects_none?) raise Capybara::ExpectationNotMet, result. end end end |
#assert_style(styles = nil, **options) ⇒ Object
Use #assert_matches_style instead.
139 140 141 142 |
# File 'lib/capybara/node/matchers.rb', line 139 def assert_style(styles = nil, **) warn 'assert_style is deprecated, please use assert_matches_style instead' assert_matches_style(styles, **) end |
#assert_text(type, text, **options) ⇒ true #assert_text(text, **options) ⇒ true
Asserts that the page or current node has the given text content, ignoring any HTML tags.
675 676 677 678 679 680 681 |
# File 'lib/capybara/node/matchers.rb', line 675 def assert_text(type_or_text, *args, **opts) _verify_text(type_or_text, *args, **opts) do |count, query| unless query.matches_count?(count) && (count.positive? || query.expects_none?) raise Capybara::ExpectationNotMet, query. end end end |
#has_ancestor?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_ancestor
761 762 763 |
# File 'lib/capybara/node/matchers.rb', line 761 def has_ancestor?(*args, **, &optional_filter_block) make_predicate() { assert_ancestor(*args, , &optional_filter_block) } end |
#has_button?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a button with the given text, value or id.
358 359 360 |
# File 'lib/capybara/node/matchers.rb', line 358 def (locator = nil, **, &optional_filter_block) has_selector?(:button, locator, **, &optional_filter_block) end |
#has_checked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a radio button or checkbox with the given label, value, id, or test_id attribute that is currently checked.
423 424 425 |
# File 'lib/capybara/node/matchers.rb', line 423 def has_checked_field?(locator = nil, **, &optional_filter_block) has_selector?(:field, locator, **.merge(checked: true), &optional_filter_block) end |
#has_css?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given CSS selector is on the page or a descendant of the current node.
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 Finders#all accepts,
such as :text
and :visible
.
page.has_css?('li', text: 'Horse', visible: true)
309 310 311 |
# File 'lib/capybara/node/matchers.rb', line 309 def has_css?(path, **, &optional_filter_block) has_selector?(:css, path, **, &optional_filter_block) end |
#has_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
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')
It is also possible to filter by the field type attribute:
page.has_field?('Email', type: 'email')
NOTE: 'textarea' and 'select' are valid type values, matching the associated tag names.
396 397 398 |
# File 'lib/capybara/node/matchers.rb', line 396 def has_field?(locator = nil, **, &optional_filter_block) has_selector?(:field, locator, **, &optional_filter_block) end |
#has_link?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a link with the given text or id.
334 335 336 |
# File 'lib/capybara/node/matchers.rb', line 334 def has_link?(locator = nil, **, &optional_filter_block) has_selector?(:link, locator, **, &optional_filter_block) end |
#has_no_ancestor?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_no_ancestor
769 770 771 |
# File 'lib/capybara/node/matchers.rb', line 769 def has_no_ancestor?(*args, **, &optional_filter_block) make_predicate() { assert_no_ancestor(*args, , &optional_filter_block) } end |
#has_no_button?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no button with the given text, value or id.
370 371 372 |
# File 'lib/capybara/node/matchers.rb', line 370 def (locator = nil, **, &optional_filter_block) has_no_selector?(:button, locator, **, &optional_filter_block) end |
#has_no_checked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no radio button or checkbox with the given label, value or id, or test_id attribute that is currently checked.
436 437 438 |
# File 'lib/capybara/node/matchers.rb', line 436 def has_no_checked_field?(locator = nil, **, &optional_filter_block) has_no_selector?(:field, locator, **.merge(checked: true), &optional_filter_block) end |
#has_no_css?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given CSS selector is not on the page or a descendant of the current node. Usage is identical to #has_css?.
321 322 323 |
# File 'lib/capybara/node/matchers.rb', line 321 def has_no_css?(path, **, &optional_filter_block) has_no_selector?(:css, path, **, &optional_filter_block) end |
#has_no_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no form field with the given label, name or id. See #has_field?.
410 411 412 |
# File 'lib/capybara/node/matchers.rb', line 410 def has_no_field?(locator = nil, **, &optional_filter_block) has_no_selector?(:field, locator, **, &optional_filter_block) end |
#has_no_link?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no link with the given text or id.
346 347 348 |
# File 'lib/capybara/node/matchers.rb', line 346 def has_no_link?(locator = nil, **, &optional_filter_block) has_no_selector?(:link, locator, **, &optional_filter_block) end |
#has_no_select?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no select field with the given label, name or id. See #has_select?.
507 508 509 |
# File 'lib/capybara/node/matchers.rb', line 507 def has_no_select?(locator = nil, **, &optional_filter_block) has_no_selector?(:select, locator, **, &optional_filter_block) end |
#has_no_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if a given selector is not on the page or a descendant of the current node. Usage is identical to #has_selector?.
50 51 52 |
# File 'lib/capybara/node/matchers.rb', line 50 def has_no_selector?(*args, **, &optional_filter_block) make_predicate() { assert_no_selector(*args, , &optional_filter_block) } end |
#has_no_sibling?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_no_sibling
812 813 814 |
# File 'lib/capybara/node/matchers.rb', line 812 def has_no_sibling?(*args, **, &optional_filter_block) make_predicate() { assert_no_sibling(*args, , &optional_filter_block) } end |
#has_no_table?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no table with the given id or caption. See #has_table?.
541 542 543 |
# File 'lib/capybara/node/matchers.rb', line 541 def has_no_table?(locator = nil, **, &optional_filter_block) has_no_selector?(:table, locator, **, &optional_filter_block) end |
#has_no_text?(type, text, **options) ⇒ Boolean #has_no_text?(text, **options) ⇒ Boolean Also known as: has_no_content?
Checks if the page or current node does not have the given text content, ignoring any HTML tags and normalizing whitespace.
725 726 727 |
# File 'lib/capybara/node/matchers.rb', line 725 def has_no_text?(*args, **) make_predicate() { assert_no_text(*args, **) } end |
#has_no_unchecked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has no radio button or checkbox with the given label, value or id, or test_id attribute that is currently unchecked.
462 463 464 |
# File 'lib/capybara/node/matchers.rb', line 462 def has_no_unchecked_field?(locator = nil, **, &optional_filter_block) has_no_selector?(:field, locator, **.merge(unchecked: true), &optional_filter_block) end |
#has_no_xpath?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given XPath expression is not on the page or a descendant of the current node. Usage is identical to #has_xpath?.
282 283 284 |
# File 'lib/capybara/node/matchers.rb', line 282 def has_no_xpath?(path, **, &optional_filter_block) has_no_selector?(:xpath, path, **, &optional_filter_block) end |
#has_select?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
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'])
It's also possible to check if the exact set of options exists for this select box:
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'])
495 496 497 |
# File 'lib/capybara/node/matchers.rb', line 495 def has_select?(locator = nil, **, &optional_filter_block) has_selector?(:select, locator, **, &optional_filter_block) end |
#has_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if a given selector is on the page or a descendant of the current node.
page.has_selector?('p#foo')
page.has_selector?(:xpath, './/p[@id="foo"]')
page.has_selector?(:foo)
By default it will check if the expression occurs at least once, but a different number can be specified.
page.has_selector?('p.foo', count: 4)
This will check if the expression occurs exactly 4 times.
It also accepts all options that Finders#all accepts,
such as :text
and :visible
.
page.has_selector?('li', text: 'Horse', visible: true)
#has_selector? can also accept XPath expressions generated by the XPath gem:
page.has_selector?(:xpath, XPath.descendant(:p))
38 39 40 |
# File 'lib/capybara/node/matchers.rb', line 38 def has_selector?(*args, **, &optional_filter_block) make_predicate() { assert_selector(*args, , &optional_filter_block) } end |
#has_sibling?(*args, **options, &optional_filter_block) ⇒ Boolean
Predicate version of #assert_sibling
804 805 806 |
# File 'lib/capybara/node/matchers.rb', line 804 def has_sibling?(*args, **, &optional_filter_block) make_predicate() { assert_sibling(*args, , &optional_filter_block) } end |
#has_style?(styles = nil, **options) ⇒ Boolean
Use #matches_style? instead.
71 72 73 74 |
# File 'lib/capybara/node/matchers.rb', line 71 def has_style?(styles = nil, **) Capybara::Helpers.warn "DEPRECATED: has_style? is deprecated, please use matches_style? : #{Capybara::Helpers.filter_backtrace(caller)}" matches_style?(styles, **) end |
#has_table?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a table with the given id or caption:
page.has_table?('People')
529 530 531 |
# File 'lib/capybara/node/matchers.rb', line 529 def has_table?(locator = nil, **, &optional_filter_block) has_selector?(:table, locator, **, &optional_filter_block) end |
#has_text?(type, text, **options) ⇒ Boolean #has_text?(text, **options) ⇒ Boolean Also known as: has_content?
Checks if the page or current node has the given text content, ignoring any HTML tags.
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.
713 714 715 |
# File 'lib/capybara/node/matchers.rb', line 713 def has_text?(*args, **) make_predicate() { assert_text(*args, **) } end |
#has_unchecked_field?(locator = nil, **options, &optional_filter_block) ⇒ Boolean
Checks if the page or current node has a radio button or checkbox with the given label, value or id, or test_id attribute that is currently unchecked.
449 450 451 |
# File 'lib/capybara/node/matchers.rb', line 449 def has_unchecked_field?(locator = nil, **, &optional_filter_block) has_selector?(:field, locator, **.merge(unchecked: true), &optional_filter_block) end |
#has_xpath?(path, **options, &optional_filter_block) ⇒ Boolean
Checks if a given XPath expression is on the page or a descendant of the current node.
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 Finders#all accepts,
such as :text
and :visible
.
page.has_xpath?('.//li', text: 'Horse', visible: true)
#has_xpath? can also accept XPath expressions generated by the XPath gem:
xpath = XPath.generate { |x| x.descendant(:p) }
page.has_xpath?(xpath)
270 271 272 |
# File 'lib/capybara/node/matchers.rb', line 270 def has_xpath?(path, **, &optional_filter_block) has_selector?(:xpath, path, **, &optional_filter_block) end |
#matches_css?(css, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node matches given CSS selector.
610 611 612 |
# File 'lib/capybara/node/matchers.rb', line 610 def matches_css?(css, **, &optional_filter_block) matches_selector?(:css, css, **, &optional_filter_block) end |
#matches_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node matches given selector.
588 589 590 |
# File 'lib/capybara/node/matchers.rb', line 588 def matches_selector?(*args, **, &optional_filter_block) make_predicate() { assert_matches_selector(*args, , &optional_filter_block) } end |
#matches_style?(styles = nil, **options) ⇒ Boolean
Checks if a an element has the specified CSS styles.
element.matches_style?( 'color' => 'rgb(0,0,255)', 'font-size' => /px/ )
63 64 65 66 |
# File 'lib/capybara/node/matchers.rb', line 63 def matches_style?(styles = nil, **) styles, = , {} if styles.nil? make_predicate() { assert_matches_style(styles, **) } end |
#matches_xpath?(xpath, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node matches given XPath expression.
599 600 601 |
# File 'lib/capybara/node/matchers.rb', line 599 def matches_xpath?(xpath, **, &optional_filter_block) matches_selector?(:xpath, xpath, **, &optional_filter_block) end |
#not_matches_css?(css, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node does not match given CSS selector.
644 645 646 |
# File 'lib/capybara/node/matchers.rb', line 644 def not_matches_css?(css, **, &optional_filter_block) not_matches_selector?(:css, css, **, &optional_filter_block) end |
#not_matches_selector?(*args, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node does not match given selector. Usage is identical to #has_selector?.
622 623 624 |
# File 'lib/capybara/node/matchers.rb', line 622 def not_matches_selector?(*args, **, &optional_filter_block) make_predicate() { assert_not_matches_selector(*args, , &optional_filter_block) } end |
#not_matches_xpath?(xpath, **options, &optional_filter_block) ⇒ Boolean
Checks if the current node does not match given XPath expression.
633 634 635 |
# File 'lib/capybara/node/matchers.rb', line 633 def not_matches_xpath?(xpath, **, &optional_filter_block) not_matches_selector?(:xpath, xpath, **, &optional_filter_block) end |