class Capybara::RackTest::Node
Constants
- BLOCK_ELEMENTS
- DISABLED_BY_FIELDSET_XPATH
- OPTION_OWNER_XPATH
Public Instance Methods
Source
# File lib/capybara/rack_test/node.rb, line 11 def all_text normalize_spacing(native.text) end
Source
# File lib/capybara/rack_test/node.rb, line 87 def checked? string_node.checked? end
Source
# File lib/capybara/rack_test/node.rb, line 61 def click(keys = [], **options) options.delete(:offset) raise ArgumentError, 'The RackTest driver does not support click options' unless keys.empty? && options.empty? if link? follow_link elsif submits? associated_form = form Capybara::RackTest::Form.new(driver, associated_form).submit(self) if associated_form elsif checkable? set(!checked?) elsif tag_name == 'label' click_label elsif (details = native.xpath('.//ancestor-or-self::details').last) toggle_details(details) end end
Source
# File lib/capybara/rack_test/node.rb, line 95 def disabled? return true if string_node.disabled? if %w[option optgroup].include? tag_name find_xpath(OPTION_OWNER_XPATH)[0].disabled? else !find_xpath(DISABLED_BY_FIELDSET_XPATH).empty? end end
Source
# File lib/capybara/rack_test/node.rb, line 120 def find_css(locator, **_hints) native.css(locator, Capybara::RackTest::CSSHandlers.new).map { |el| self.class.new(driver, el) } end
Source
# File lib/capybara/rack_test/node.rb, line 116 def find_xpath(locator, **_hints) native.xpath(locator).map { |el| self.class.new(driver, el) } end
Source
# File lib/capybara/rack_test/node.rb, line 105 def readonly? # readonly attribute not valid on these input types return false if input_field? && %w[hidden range color checkbox radio file submit image reset button].include?(type) super end
Calls superclass method
Capybara::Driver::Node#readonly?
Source
# File lib/capybara/rack_test/node.rb, line 48 def select_option return if disabled? deselect_options unless select_node.multiple? native['selected'] = 'selected' end
Source
# File lib/capybara/rack_test/node.rb, line 91 def selected? string_node.selected? end
Source
# File lib/capybara/rack_test/node.rb, line 31 def set(value, **options) return if disabled? || readonly? warn "Options passed to Node#set but the RackTest driver doesn't support any - ignoring" unless options.empty? if value.is_a?(Array) && !multiple? raise TypeError, "Value cannot be an Array when 'multiple' attribute is not present. Not a #{value.class}" end if radio? then set_radio(value) elsif checkbox? then set_checkbox(value) elsif range? then set_range(value) elsif input_field? then set_input(value) elsif textarea? then native['_capybara_raw_value'] = value.to_s end end
Source
# File lib/capybara/rack_test/node.rb, line 23 def style(_styles) raise NotImplementedError, 'The rack_test driver does not process CSS' end
Source
# File lib/capybara/rack_test/node.rb, line 55 def unselect_option raise Capybara::UnselectNotAllowed, 'Cannot unselect option from single select box.' unless select_node.multiple? native.remove_attribute('selected') end
Source
# File lib/capybara/rack_test/node.rb, line 83 def visible? string_node.visible? end
Source
# File lib/capybara/rack_test/node.rb, line 15 def visible_text normalize_visible_spacing(displayed_text) end
Protected Instance Methods
Source
# File lib/capybara/rack_test/node.rb, line 294 def checkbox? input_field? && type == 'checkbox' end
Source
# File lib/capybara/rack_test/node.rb, line 290 def checkbox_or_radio?(field = self) field&.checkbox? || field&.radio? end
Source
# File lib/capybara/rack_test/node.rb, line 146 def displayed_text(check_ancestor: true) if !string_node.visible?(check_ancestor) '' elsif native.text? native .text .delete(REMOVED_CHARACTERS) .tr(SQUEEZED_SPACES, ' ') .squeeze(' ') elsif native.element? text = native.children.map do |child| Capybara::RackTest::Node.new(driver, child).displayed_text(check_ancestor: false) end.join || '' text = "\n#{text}\n" if BLOCK_ELEMENTS.include?(tag_name) text else # rubocop:disable Lint/DuplicateBranch '' end end
@api private
Source
# File lib/capybara/rack_test/node.rb, line 306 def input_field? tag_name == 'input' end
Source
# File lib/capybara/rack_test/node.rb, line 298 def radio? input_field? && type == 'radio' end
Source
# File lib/capybara/rack_test/node.rb, line 314 def range? input_field? && type == 'range' end
Source
# File lib/capybara/rack_test/node.rb, line 302 def text_or_password? input_field? && (type == 'text' || type == 'password') end
Source
# File lib/capybara/rack_test/node.rb, line 310 def textarea? tag_name == 'textarea' end
Private Instance Methods
Source
# File lib/capybara/rack_test/node.rb, line 245 def attribute_is_not_blank?(attribute) self[attribute] && !self[attribute].empty? end
Source
# File lib/capybara/rack_test/node.rb, line 284 def checkable? tag_name == 'input' && %w[checkbox radio].include?(type) end
Source
# File lib/capybara/rack_test/node.rb, line 255 def click_label labelled_control = if native[:for] find_xpath("//input[@id='#{native[:for]}']") else find_xpath('.//input') end.first labelled_control.set(!labelled_control.checked?) if checkbox_or_radio?(labelled_control) end
Source
# File lib/capybara/rack_test/node.rb, line 172 def deselect_options select_node.find_xpath('.//option[@selected]').each { |node| node.native.remove_attribute('selected') } end
Source
# File lib/capybara/rack_test/node.rb, line 249 def follow_link method = self['data-method'] || self['data-turbo-method'] if driver.options[:respect_data_method] method ||= :get driver.follow(method, self[:href].to_s) end
Source
# File lib/capybara/rack_test/node.rb, line 189 def form if native[:form] native.xpath("//form[@id='#{native[:form]}']") else native.ancestors('form') end.first end
Source
# File lib/capybara/rack_test/node.rb, line 276 def link? tag_name == 'a' && !self[:href].nil? end
Source
# File lib/capybara/rack_test/node.rb, line 181 def select_node find_xpath('./ancestor::select[1]').first end
a reference to the select node if this is an option node
Source
# File lib/capybara/rack_test/node.rb, line 203 def set_checkbox(value) # rubocop:disable Naming/AccessorMethodName if value && !native['checked'] native['checked'] = 'checked' elsif !value && native['checked'] native.remove_attribute('checked') end end
Source
# File lib/capybara/rack_test/node.rb, line 219 def set_input(value) # rubocop:disable Naming/AccessorMethodName if text_or_password? && attribute_is_not_blank?(:maxlength) # Browser behavior for maxlength="0" is inconsistent, so we stick with # Firefox, allowing no input value = value.to_s[0...self[:maxlength].to_i] end if value.is_a?(Array) # Assert multiple attribute is present value.each do |val| new_native = native.clone new_native.remove_attribute('value') native.add_next_sibling(new_native) new_native['value'] = val.to_s end native.remove else value.to_s.tap do |set_value| if set_value.end_with?("\n") && form&.css('input, textarea')&.count native['value'] = set_value.to_s.chop Capybara::RackTest::Form.new(driver, form).submit(self) else native['value'] = set_value end end end end
Source
# File lib/capybara/rack_test/node.rb, line 197 def set_radio(_value) # rubocop:disable Naming/AccessorMethodName other_radios_xpath = XPath.generate { |xp| xp.anywhere(:input)[xp.attr(:name) == self[:name]] }.to_s driver.dom.xpath(other_radios_xpath).each { |node| node.remove_attribute('checked') } native['checked'] = 'checked' end
Source
# File lib/capybara/rack_test/node.rb, line 211 def set_range(value) # rubocop:disable Naming/AccessorMethodName min, max, step = (native['min'] || 0).to_f, (native['max'] || 100).to_f, (native['step'] || 1).to_f value = value.to_f value = value.clamp(min, max) value = (((value - min) / step).round * step) + min native['value'] = value.clamp(min, max) end
Source
# File lib/capybara/rack_test/node.rb, line 168 def stale_check raise Capybara::RackTest::Errors::StaleElementReferenceError unless native.document == driver.dom end
Source
# File lib/capybara/rack_test/node.rb, line 176 def string_node @string_node ||= Capybara::Node::Simple.new(native) end
Source
# File lib/capybara/rack_test/node.rb, line 280 def submits? (tag_name == 'input' && %w[submit image].include?(type)) || (tag_name == 'button' && [nil, 'submit'].include?(type)) end
Source
# File lib/capybara/rack_test/node.rb, line 265 def toggle_details(details = nil) details ||= native.xpath('.//ancestor-or-self::details').last return unless details if details.has_attribute?('open') details.remove_attribute('open') else details.set_attribute('open', 'open') end end