Class: Capybara::Node::Simple
- Inherits:
-
Object
- Object
- Capybara::Node::Simple
- Includes:
- Minitest::Expectations, DocumentMatchers, Finders, Matchers
- Defined in:
- lib/capybara/node/simple.rb,
lib/capybara/minitest/spec.rb
Overview
A Simple is a simpler version of Base which includes only Finders and Matchers and does not include Actions. This type of node is returned when using Capybara.string.
It is useful in that it does not require a session, an application or a driver, but can still use Capybara's finders and matchers on any string that contains HTML.
Instance Attribute Summary collapse
-
#native ⇒ Object
readonly
Returns the value of attribute native.
Instance Method Summary collapse
- #==(other) ⇒ Object
-
#[](name) ⇒ String
Retrieve the given attribute.
- #allow_reload! ⇒ Object
-
#checked? ⇒ Boolean
Whether or not the element is checked.
-
#disabled? ⇒ Boolean
Whether or not the element is disabled.
- #find_css(css, **_options) ⇒ Object private
- #find_xpath(xpath, **_options) ⇒ Object private
- #initial_cache ⇒ Object private
-
#initialize(native) ⇒ Simple
constructor
A new instance of Simple.
- #inspect ⇒ Object
- #multiple? ⇒ Boolean
-
#path ⇒ String
An XPath expression describing where on the page the element can be found.
- #readonly? ⇒ Boolean
-
#selected? ⇒ Boolean
Whether or not the element is selected.
- #session_options ⇒ Object private
- #synchronize(_seconds = nil) ⇒ Object
-
#tag_name ⇒ String
The tag name of the element.
-
#text(_type = nil, normalize_ws: false) ⇒ String
The text of the element.
-
#title ⇒ String
The title of the document.
-
#value ⇒ String
The value of the form element.
-
#visible?(check_ancestors = true) ⇒ Boolean
Whether or not the element is visible.
Methods included from Minitest::Expectations
#must_have_all_of_selectors, #must_have_ancestor, #must_have_any_of_selectors, #must_have_button, #must_have_checked_field, #must_have_content, #must_have_css, #must_have_current_path, #must_have_element, #must_have_field, #must_have_link, #must_have_none_of_selectors, #must_have_select, #must_have_selector, #must_have_sibling, #must_have_style, #must_have_table, #must_have_text, #must_have_title, #must_have_unchecked_field, #must_have_xpath, #must_match_style, #wont_have_button, #wont_have_checked_field, #wont_have_content, #wont_have_css, #wont_have_current_path, #wont_have_element, #wont_have_field, #wont_have_link, #wont_have_select, #wont_have_selector, #wont_have_table, #wont_have_text, #wont_have_title, #wont_have_unchecked_field, #wont_have_xpath
Methods included from DocumentMatchers
#assert_no_title, #assert_title, #has_no_title?, #has_title?
Methods included from Matchers
#assert_all_of_selectors, #assert_ancestor, #assert_any_of_selectors, #assert_matches_selector, #assert_matches_style, #assert_no_ancestor, #assert_no_selector, #assert_no_sibling, #assert_no_text, #assert_none_of_selectors, #assert_not_matches_selector, #assert_selector, #assert_sibling, #assert_style, #assert_text, #has_ancestor?, #has_button?, #has_checked_field?, #has_css?, #has_element?, #has_field?, #has_link?, #has_no_ancestor?, #has_no_button?, #has_no_checked_field?, #has_no_css?, #has_no_element?, #has_no_field?, #has_no_link?, #has_no_select?, #has_no_selector?, #has_no_sibling?, #has_no_table?, #has_no_text?, #has_no_unchecked_field?, #has_no_xpath?, #has_select?, #has_selector?, #has_sibling?, #has_style?, #has_table?, #has_text?, #has_unchecked_field?, #has_xpath?, #matches_css?, #matches_selector?, #matches_style?, #matches_xpath?, #not_matches_css?, #not_matches_selector?, #not_matches_xpath?
Methods included from Finders
#all, #ancestor, #find, #find_button, #find_by_id, #find_field, #find_link, #first, #sibling
Constructor Details
Instance Attribute Details
#native ⇒ Object (readonly)
Returns the value of attribute native.
20 21 22 |
# File 'lib/capybara/node/simple.rb', line 20 def native @native end |
Instance Method Details
#==(other) ⇒ Object
194 195 196 |
# File 'lib/capybara/node/simple.rb', line 194 def ==(other) eql?(other) || (other.respond_to?(:native) && native == other.native) end |
#[](name) ⇒ String
Retrieve the given attribute
element[:title] # => HTML title attribute
45 46 47 48 49 50 51 52 53 54 |
# File 'lib/capybara/node/simple.rb', line 45 def [](name) attr_name = name.to_s if attr_name == 'value' value elsif (tag_name == 'input') && (native[:type] == 'checkbox') && (attr_name == 'checked') native['checked'] == 'checked' else native[attr_name] end end |
#allow_reload! ⇒ Object
159 160 161 |
# File 'lib/capybara/node/simple.rb', line 159 def allow_reload!(*) # no op end |
#checked? ⇒ Boolean
Whether or not the element is checked.
123 124 125 |
# File 'lib/capybara/node/simple.rb', line 123 def checked? native.has_attribute?('checked') end |
#disabled? ⇒ Boolean
Whether or not the element is disabled.
132 133 134 135 |
# File 'lib/capybara/node/simple.rb', line 132 def disabled? native.has_attribute?('disabled') && %w[button input select textarea optgroup option menuitem fieldset].include?(tag_name) end |
#find_css(css, **_options) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
175 176 177 |
# File 'lib/capybara/node/simple.rb', line 175 def find_css(css, **) native.css(css) end |
#find_xpath(xpath, **_options) ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
180 181 182 |
# File 'lib/capybara/node/simple.rb', line 180 def find_xpath(xpath, **) native.xpath(xpath) end |
#initial_cache ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
190 191 192 |
# File 'lib/capybara/node/simple.rb', line 190 def initial_cache {} end |
#inspect ⇒ Object
170 171 172 |
# File 'lib/capybara/node/simple.rb', line 170 def inspect %(#<Capybara::Node::Simple tag="#{tag_name}" path="#{path}">) end |
#multiple? ⇒ Boolean
147 148 149 |
# File 'lib/capybara/node/simple.rb', line 147 def multiple? native.has_attribute?('multiple') end |
#path ⇒ String
An XPath expression describing where on the page the element can be found
70 71 72 |
# File 'lib/capybara/node/simple.rb', line 70 def path native.path end |
#readonly? ⇒ Boolean
151 152 153 |
# File 'lib/capybara/node/simple.rb', line 151 def readonly? native.has_attribute?('readonly') end |
#selected? ⇒ Boolean
Whether or not the element is selected.
143 144 145 |
# File 'lib/capybara/node/simple.rb', line 143 def selected? native.has_attribute?('selected') end |
#session_options ⇒ Object
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
185 186 187 |
# File 'lib/capybara/node/simple.rb', line 185 def Capybara. end |
#synchronize(_seconds = nil) ⇒ Object
155 156 157 |
# File 'lib/capybara/node/simple.rb', line 155 def synchronize(_seconds = nil) yield # simple nodes don't need to wait end |
#tag_name ⇒ String
Returns The tag name of the element.
60 61 62 |
# File 'lib/capybara/node/simple.rb', line 60 def tag_name native.node_name end |
#text(_type = nil, normalize_ws: false) ⇒ String
Returns The text of the element.
31 32 33 34 |
# File 'lib/capybara/node/simple.rb', line 31 def text(_type = nil, normalize_ws: false) txt = native.text normalize_ws ? txt.gsub(/[[:space:]]+/, ' ').strip : txt end |
#title ⇒ String
Returns The title of the document.
166 167 168 |
# File 'lib/capybara/node/simple.rb', line 166 def title native.title end |
#value ⇒ String
Returns The value of the form element.
78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/capybara/node/simple.rb', line 78 def value if tag_name == 'textarea' native['_capybara_raw_value'] elsif tag_name == 'select' = find_xpath('.//option[@selected]') if multiple? .map(&method(:option_value)) else option_value(.first || find_xpath('.//option').first) end elsif tag_name == 'input' && %w[radio checkbox].include?(native[:type]) native[:value] || 'on' else native[:value] end end |
#visible?(check_ancestors = true) ⇒ Boolean
Whether or not the element is visible. Does not support CSS, so the result may be inaccurate.
103 104 105 106 107 108 109 110 111 112 113 114 115 |
# File 'lib/capybara/node/simple.rb', line 103 def visible?(check_ancestors = true) # rubocop:disable Style/OptionalBooleanParameter return false if (tag_name == 'input') && (native[:type] == 'hidden') return false if tag_name == 'template' if check_ancestors !find_xpath(VISIBILITY_XPATH) else # No need for an xpath if only checking the current element !(native.key?('hidden') || /display:\s?none/.match?(native[:style] || '') || %w[script head style].include?(tag_name)) end end |