Class: Capybara::Selenium::Node

Inherits:
Driver::Node show all
Includes:
Find, Scroll
Defined in:
lib/capybara/selenium/node.rb,
lib/capybara/selenium/extensions/html5_drag.rb,
lib/capybara/selenium/extensions/modifier_keys_stack.rb

Direct Known Subclasses

ChromeNode, EdgeNode, FirefoxNode, IENode, SafariNode

Defined Under Namespace

Modules: Html5Drag Classes: ModifierKeysStack

Instance Attribute Summary

Attributes inherited from Driver::Node

#driver, #initial_cache, #native

Instance Method Summary collapse

Methods included from Scroll

#scroll_by, #scroll_to

Methods included from Find

#find_css, #find_xpath

Methods inherited from Driver::Node

#initialize, #inspect, #scroll_by, #scroll_to, #trigger

Constructor Details

This class inherits a constructor from Capybara::Driver::Node

Instance Method Details

#==(other) ⇒ Object 



167
168
169
 
# File 'lib/capybara/selenium/node.rb', line 167

def ==(other)
  native == other.native
end

#[](name) ⇒ Object 



25
26
27
28
29
 
# File 'lib/capybara/selenium/node.rb', line 25

def [](name)
  native.attribute(name.to_s)
rescue Selenium::WebDriver::Error::WebDriverError
  nil
end

#all_text ⇒ Object 



16
17
18
19
20
21
22
23
 
# File 'lib/capybara/selenium/node.rb', line 16

def all_text
  text = driver.evaluate_script('arguments[0].textContent', self)
  text.gsub(/[\u200b\u200e\u200f]/, '')
      .gsub(/[\ \n\f\t\v\u2028\u2029]+/, ' ')
      .gsub(/\A[[:space:]&&[^\u00a0]]+/, '')
      .gsub(/[[:space:]&&[^\u00a0]]+\z/, '')
      .tr("\u00a0", ' ')
end

#click(keys = [], **options) ⇒ Object 



99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/capybara/selenium/node.rb', line 99

def click(keys = [], **options)
  click_options = ClickOptions.new(keys, options)
  return native.click if click_options.empty?

  click_with_options(click_options)
rescue StandardError => e
  if e.is_a?(::Selenium::WebDriver::Error::ElementClickInterceptedError) ||
     e.message.match?(/Other element would receive the click/)
    scroll_to_center
  end

  raise e
end

#content_editable? ⇒ Boolean

Returns:

  • (Boolean) 


163
164
165
 
# File 'lib/capybara/selenium/node.rb', line 163

def content_editable?
  native.attribute('isContentEditable') == 'true'
end

#disabled? ⇒ Boolean

Returns:

  • (Boolean) 


156
157
158
159
160
161
 
# File 'lib/capybara/selenium/node.rb', line 156

def disabled?
  return true unless native.enabled?

  # WebDriver only defines `disabled?` for form controls but fieldset makes sense too
  find_xpath('self::fieldset/ancestor-or-self::fieldset[@disabled]').any?
end

#double_click(keys = [], **options) ⇒ Object 



120
121
122
123
124
125
 
# File 'lib/capybara/selenium/node.rb', line 120

def double_click(keys = [], **options)
  click_options = ClickOptions.new(keys, options)
  click_with_options(click_options) do |action|
    click_options.coords? ? action.double_click : action.double_click(native)
  end
end

#drag_to(element) ⇒ Object 



135
136
137
138
139
140
 
# File 'lib/capybara/selenium/node.rb', line 135

def drag_to(element, **)
  # Due to W3C spec compliance - The Actions API no longer scrolls to elements when necessary
  # which means Seleniums `drag_and_drop` is now broken - do it manually
  scroll_if_needed { browser_action.click_and_hold(native).perform }
  element.scroll_if_needed { browser_action.move_to(element.native).release.perform }
end

#drop(*_) ⇒ Object

Raises:

  • (NotImplementedError) 


142
143
144
 
# File 'lib/capybara/selenium/node.rb', line 142

def drop(*_)
  raise NotImplementedError, 'Out of browser drop emulation is not implemented for the current browser'
end

#hover ⇒ Object 



131
132
133
 
# File 'lib/capybara/selenium/node.rb', line 131

def hover
  scroll_if_needed { browser_action.move_to(native).perform }
end

#multiple? ⇒ Boolean

Returns:

  • (Boolean) 


152
 
# File 'lib/capybara/selenium/node.rb', line 152

def multiple?; boolean_attr(self[:multiple]); end

#obscured?(x: nil, y: nil) ⇒ Boolean

Returns:

  • (Boolean) 


175
176
177
178
179
180
 
# File 'lib/capybara/selenium/node.rb', line 175

def obscured?(x: nil, y: nil)
  res = driver.evaluate_script(OBSCURED_OR_OFFSET_SCRIPT, self, x, y)
  return true if res == true

  driver.frame_obscured_at?(x: res['x'], y: res['y'])
end

#path ⇒ Object 



171
172
173
 
# File 'lib/capybara/selenium/node.rb', line 171

def path
  driver.evaluate_script GET_XPATH_SCRIPT, self
end

#readonly? ⇒ Boolean

Returns:

  • (Boolean) 


151
 
# File 'lib/capybara/selenium/node.rb', line 151

def readonly?; boolean_attr(self[:readonly]); end

#right_click(keys = [], **options) ⇒ Object 



113
114
115
116
117
118
 
# File 'lib/capybara/selenium/node.rb', line 113

def right_click(keys = [], **options)
  click_options = ClickOptions.new(keys, options)
  click_with_options(click_options) do |action|
    click_options.coords? ? action.context_click : action.context_click(native)
  end
end

#select_option ⇒ Object 



89
90
91
 
# File 'lib/capybara/selenium/node.rb', line 89

def select_option
  click unless selected? || disabled?
end

#selected? ⇒ Boolean Also known as: checked?

Returns:

  • (Boolean) 


153
 
# File 'lib/capybara/selenium/node.rb', line 153

def selected?; boolean_attr(native.selected?); end

#send_keys(*args) ⇒ Object 



127
128
129
 
# File 'lib/capybara/selenium/node.rb', line 127

def send_keys(*args)
  native.send_keys(*args)
end

#set(value, **options) ⇒ Object

Set the value of the form element to the given value.

Parameters:

  • value (String) —

    The new value

  • options (Hash{}) —

    Driver specific options for how to set the value

Options Hash (**options):

  • :clear (Symbol, Array) — default: nil —

    The method used to clear the previous value
    nil => clear via javascript
    :none => append the new value to the existing value
    :backspace => send backspace keystrokes to clear the field
    Array => an array of keys to send before the value being set, e.g. [[:command, 'a'], :backspace]

Raises:

  • (ArgumentError) 


56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/capybara/selenium/node.rb', line 56

def set(value, **options)
  raise ArgumentError, "Value cannot be an Array when 'multiple' attribute is not present. Not a #{value.class}" if value.is_a?(Array) && !multiple?

  tag_name, type = attrs(:tagName, :type).map { |val| val&.downcase }
  @tag_name ||= tag_name

  case tag_name
  when 'input'
    case type
    when 'radio'
      click
    when 'checkbox'
      click if value ^ checked?
    when 'file'
      set_file(value)
    when 'date'
      set_date(value)
    when 'time'
      set_time(value)
    when 'datetime-local'
      set_datetime_local(value)
    when 'color'
      set_color(value)
    else
      set_text(value, options)
    end
  when 'textarea'
    set_text(value, options)
  else
    set_content_editable(value)
  end
end

#style(styles) ⇒ Object 



39
40
41
42
43
 
# File 'lib/capybara/selenium/node.rb', line 39

def style(styles)
  styles.each_with_object({}) do |style, result|
    result[style] = native.css_value(style)
  end
end

#tag_name ⇒ Object 



146
147
148
 
# File 'lib/capybara/selenium/node.rb', line 146

def tag_name
  @tag_name ||= native.tag_name.downcase
end

#unselect_option ⇒ Object

Raises:



93
94
95
96
97
 
# File 'lib/capybara/selenium/node.rb', line 93

def unselect_option
  raise Capybara::UnselectNotAllowed, 'Cannot unselect option from single select box.' unless select_node.multiple?

  click if selected?
end

#value ⇒ Object 



31
32
33
34
35
36
37
 
# File 'lib/capybara/selenium/node.rb', line 31

def value
  if tag_name == 'select' && multiple?
    native.find_elements(:css, 'option:checked').map { |el| el[:value] || el.text }
  else
    native[:value]
  end
end

#visible? ⇒ Boolean

Returns:

  • (Boolean) 


150
 
# File 'lib/capybara/selenium/node.rb', line 150

def visible?; boolean_attr(native.displayed?); end

#visible_text ⇒ Object 



12
13
14
 
# File 'lib/capybara/selenium/node.rb', line 12

def visible_text
  native.text
end