class Capybara::RackTest::Node

Constants

BLOCK_ELEMENTS

Public Instance Methods

==(other) click to toggle source
# File lib/capybara/rack_test/node.rb, line 111
def ==(other)
  native == other.native
end
[](name) click to toggle source
# File lib/capybara/rack_test/node.rb, line 23
def [](name)
  string_node[name]
end
all_text() click to toggle source
# File lib/capybara/rack_test/node.rb, line 6
def all_text
  native.text
        .gsub(/[\u200b\u200e\u200f]/, '')
        .gsub(/[\ \n\f\t\v\u2028\u2029]+/, ' ')
        .gsub(/\A[[:space:]&&[^\u00a0]]+/, "")
        .gsub(/[[:space:]&&[^\u00a0]]+\z/, "")
        .tr("\u00a0", ' ')
end
checked?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 81
def checked?
  string_node.checked?
end
click(keys = [], offset = {}) click to toggle source
# File lib/capybara/rack_test/node.rb, line 58
def click(keys = [], offset = {})
  raise ArgumentError, "The RackTest driver does not support click options" unless keys.empty? && offset.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
  end
end
disabled?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 89
def disabled?
  return true if string_node.disabled?

  if %w[option optgroup].include? tag_name
    find_xpath("parent::*[self::optgroup or self::select]")[0].disabled?
  else
    !find_xpath("parent::fieldset[@disabled] | ancestor::*[not(self::legend) or preceding-sibling::legend][parent::fieldset[@disabled]]").empty?
  end
end
find_css(locator) click to toggle source
# File lib/capybara/rack_test/node.rb, line 107
def find_css(locator)
  native.css(locator, Capybara::RackTest::CSSHandlers.new).map { |n| self.class.new(driver, n) }
end
find_xpath(locator) click to toggle source
# File lib/capybara/rack_test/node.rb, line 103
def find_xpath(locator)
  native.xpath(locator).map { |n| self.class.new(driver, n) }
end
path() click to toggle source
# File lib/capybara/rack_test/node.rb, line 99
def path
  native.path
end
select_option() click to toggle source
# File lib/capybara/rack_test/node.rb, line 47
def select_option
  return if disabled?
  deselect_options unless select_node.multiple?
  native["selected"] = 'selected'
end
selected?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 85
def selected?
  string_node.selected?
end
set(value, **options) click to toggle 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 input_field? then set_input(value)
  elsif textarea? then native['_capybara_raw_value'] = value.to_s
  end
end
tag_name() click to toggle source
# File lib/capybara/rack_test/node.rb, line 73
def tag_name
  native.node_name
end
unselect_option() click to toggle source
# File lib/capybara/rack_test/node.rb, line 53
def unselect_option
  raise Capybara::UnselectNotAllowed, "Cannot unselect option from single select box." unless select_node.multiple?
  native.remove_attribute('selected')
end
value() click to toggle source
# File lib/capybara/rack_test/node.rb, line 27
def value
  string_node.value
end
visible?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 77
def visible?
  string_node.visible?
end
visible_text() click to toggle source
# File lib/capybara/rack_test/node.rb, line 15
def visible_text
  displayed_text.gsub(/\ +/, ' ')
                .gsub(/[\ \n]*\n[\ \n]*/, "\n")
                .gsub(/\A[[:space:]&&[^\u00a0]]+/, "")
                .gsub(/[[:space:]&&[^\u00a0]]+\z/, "")
                .tr("\u00a0", ' ')
end

Protected Instance Methods

checkbox?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 232
def checkbox?
  input_field? && type == 'checkbox'
end
displayed_text(check_ancestor: true) click to toggle source

@api private

# File lib/capybara/rack_test/node.rb, line 118
def displayed_text(check_ancestor: true)
  if !string_node.visible?(check_ancestor)
    ''
  elsif native.text?
    native.text
          .gsub(/[\u200b\u200e\u200f]/, '')
          .gsub(/[\ \n\f\t\v\u2028\u2029]+/, ' ')
  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
    ''
  end
end
input_field?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 236
def input_field?
  tag_name == 'input'
end
radio?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 240
def radio?
  input_field? && type == 'radio'
end
text_or_password?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 248
def text_or_password?
  input_field? && (type == 'text' || type == 'password')
end
textarea?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 244
def textarea?
  tag_name == "textarea"
end

Private Instance Methods

attribute_is_not_blank?(attribute) click to toggle source
# File lib/capybara/rack_test/node.rb, line 196
def attribute_is_not_blank?(attribute)
  self[attribute] && !self[attribute].empty?
end
checkable?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 226
def checkable?
  tag_name == 'input' and %w[checkbox radio].include?(type)
end
click_label() click to toggle source
# File lib/capybara/rack_test/node.rb, line 206
def click_label
  labelled_control = if native[:for]
    find_xpath("//input[@id='#{native[:for]}']")
  else
    find_xpath(".//input")
  end.first

  if labelled_control && (labelled_control.checkbox? || labelled_control.radio?)
    labelled_control.set(!labelled_control.checked?)
  end
end
deselect_options() click to toggle source
# File lib/capybara/rack_test/node.rb, line 138
def deselect_options
  select_node.find_xpath(".//option[@selected]").each { |node| node.native.remove_attribute("selected") }
end
form() click to toggle source
# File lib/capybara/rack_test/node.rb, line 155
def form
  if native[:form]
    native.xpath("//form[@id='#{native[:form]}']")
  else
    native.ancestors('form')
  end.first
end
select_node() click to toggle source

a reference to the select node if this is an option node

# File lib/capybara/rack_test/node.rb, line 147
def select_node
  find_xpath('./ancestor::select[1]').first
end
set_checkbox(value) click to toggle source
# File lib/capybara/rack_test/node.rb, line 169
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
set_input(value) click to toggle source
# File lib/capybara/rack_test/node.rb, line 177
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 |v|
      new_native = native.clone
      new_native.remove_attribute('value')
      native.add_next_sibling(new_native)
      new_native['value'] = v.to_s
    end
    native.remove
  else
    native['value'] = value.to_s
  end
end
set_radio(_value) click to toggle source
# File lib/capybara/rack_test/node.rb, line 163
def set_radio(_value) # rubocop:disable Naming/AccessorMethodName
  other_radios_xpath = XPath.generate { |x| x.anywhere(:input)[x.attr(:name) == self[:name]] }.to_s
  driver.dom.xpath(other_radios_xpath).each { |node| node.remove_attribute("checked") }
  native['checked'] = 'checked'
end
string_node() click to toggle source
# File lib/capybara/rack_test/node.rb, line 142
def string_node
  @string_node ||= Capybara::Node::Simple.new(native)
end
submits?() click to toggle source
# File lib/capybara/rack_test/node.rb, line 222
def submits?
  (tag_name == 'input' and %w[submit image].include?(type)) || (tag_name == 'button' and [nil, "submit"].include?(type))
end
type() click to toggle source
# File lib/capybara/rack_test/node.rb, line 151
def type
  native[:type]
end