Class: Capybara::Node::Element
- Defined in:
- lib/capybara/node/element.rb
Overview
A Element represents a single element on the page. It is possible to interact with the contents of this element the same as with a document:
session = Capybara::Session.new(:rack_test, my_app)
= session.find('#bar') # from Capybara::Node::Finders
.select('Baz', from: 'Quox') # from Capybara::Node::Actions
Element also has access to HTML attributes and other properties of the element:
.value
.text
[:title]
Constant Summary collapse
- STYLE_SCRIPT =
<<~JS (function(){ var s = window.getComputedStyle(this); var result = {}; for (var i = arguments.length; i--; ) { var property_name = arguments[i]; result[property_name] = s.getPropertyValue(property_name); } return result; }).apply(this, arguments) JS
Instance Attribute Summary
Attributes inherited from Base
Instance Method Summary collapse
-
#[](attribute) ⇒ String
Retrieve the given attribute.
- #allow_reload! ⇒ Object
-
#checked? ⇒ Boolean
Whether or not the element is checked.
-
#click(*modifier_keys, **offset) ⇒ Capybara::Node::Element
Click the Element.
-
#disabled? ⇒ Boolean
Whether or not the element is disabled.
-
#double_click(*modifier_keys, **offset) ⇒ Capybara::Node::Element
Double Click the Element.
-
#drag_to(node) ⇒ Capybara::Node::Element
Drag the element to the given other element.
-
#evaluate_async_script(script, *args) ⇒ Object
Evaluate the given JavaScript in the context of the element and obtain the result from a callback function which will be passed as the last argument to the script.
-
#evaluate_script(script, *args) ⇒ Object
Evaluate the given JS in the context of the element and return the result.
-
#execute_script(script, *args) ⇒ Object
Execute the given JS in the context of the element not returning a result.
-
#hover ⇒ Capybara::Node::Element
Hover on the Element.
-
#initialize(session, base, query_scope, query) ⇒ Element
constructor
A new instance of Element.
- #inspect ⇒ Object
-
#multiple? ⇒ Boolean
Whether or not the element supports multiple results.
-
#native ⇒ Object
The native element from the driver, this allows access to driver specific methods.
-
#path ⇒ String
An XPath expression describing where on the page the element can be found.
-
#readonly? ⇒ Boolean
Whether or not the element is readonly.
- #reload ⇒ Object
-
#right_click(*modifier_keys, **offset) ⇒ Capybara::Node::Element
Right Click the Element.
-
#select_option ⇒ Capybara::Node::Element
Select this node if is an option element inside a select tag.
-
#selected? ⇒ Boolean
Whether or not the element is selected.
-
#send_keys(keys, ...) ⇒ Capybara::Node::Element
Send Keystrokes to the Element.
-
#set(value, **options) ⇒ Capybara::Node::Element
Set the value of the form element to the given value.
-
#style(*styles) ⇒ Hash
Retrieve the given CSS styles.
-
#tag_name ⇒ String
The tag name of the element.
-
#text(type = nil) ⇒ String
Retrieve the text of the element.
-
#trigger(event) ⇒ Capybara::Node::Element
Trigger any event on the current element, for example mouseover or focus events.
-
#unselect_option ⇒ Capybara::Node::Element
Unselect this node if is an option element inside a multiple select tag.
-
#value ⇒ String
The value of the form element.
-
#visible? ⇒ Boolean
Whether or not the element is visible.
Methods inherited from Base
#find_css, #find_xpath, #session_options, #synchronize, #to_capybara_node
Methods included from Matchers
#==, #assert_all_of_selectors, #assert_matches_selector, #assert_no_selector, #assert_no_text, #assert_none_of_selectors, #assert_not_matches_selector, #assert_selector, #assert_style, #assert_text, #has_button?, #has_checked_field?, #has_css?, #has_field?, #has_link?, #has_no_button?, #has_no_checked_field?, #has_no_css?, #has_no_field?, #has_no_link?, #has_no_select?, #has_no_selector?, #has_no_table?, #has_no_text?, #has_no_unchecked_field?, #has_no_xpath?, #has_select?, #has_selector?, #has_style?, #has_table?, #has_text?, #has_unchecked_field?, #has_xpath?, #matches_css?, #matches_selector?, #matches_xpath?, #not_matches_css?, #not_matches_selector?, #not_matches_xpath?
Methods included from Actions
#attach_file, #check, #choose, #click_button, #click_link, #click_link_or_button, #fill_in, #select, #uncheck, #unselect
Methods included from Finders
#all, #ancestor, #find, #find_button, #find_by_id, #find_field, #find_link, #first, #sibling
Constructor Details
#initialize(session, base, query_scope, query) ⇒ Element
Returns a new instance of Element.
25 26 27 28 29 30 |
# File 'lib/capybara/node/element.rb', line 25 def initialize(session, base, query_scope, query) super(session, base) @query_scope = query_scope @query = query @allow_reload = false end |
Instance Method Details
#[](attribute) ⇒ String
Retrieve the given attribute
element[:title] # => HTML title attribute
70 71 72 |
# File 'lib/capybara/node/element.rb', line 70 def [](attribute) synchronize { base[attribute] } end |
#allow_reload! ⇒ Object
32 33 34 |
# File 'lib/capybara/node/element.rb', line 32 def allow_reload! @allow_reload = true end |
#checked? ⇒ Boolean
Whether or not the element is checked.
290 291 292 |
# File 'lib/capybara/node/element.rb', line 290 def checked? synchronize { base.checked? } end |
#click(*modifier_keys, **offset) ⇒ Capybara::Node::Element
Click the Element
Both x: and y: must be specified if an offset is wanted, if not specified the click will occur at the middle of the element
152 153 154 155 |
# File 'lib/capybara/node/element.rb', line 152 def click(*keys, **offset) synchronize { base.click(keys, offset) } self end |
#disabled? ⇒ Boolean
Whether or not the element is disabled.
310 311 312 |
# File 'lib/capybara/node/element.rb', line 310 def disabled? synchronize { base.disabled? } end |
#double_click(*modifier_keys, **offset) ⇒ Capybara::Node::Element
Double Click the Element
Both x: and y: must be specified if an offset is wanted, if not specified the click will occur at the middle of the element
174 175 176 177 |
# File 'lib/capybara/node/element.rb', line 174 def double_click(*keys, **offset) synchronize { base.double_click(keys, offset) } self end |
#drag_to(node) ⇒ Capybara::Node::Element
Drag the element to the given other element.
source = page.find('#foo')
target = page.find('#bar')
source.drag_to(target)
368 369 370 371 |
# File 'lib/capybara/node/element.rb', line 368 def drag_to(node) synchronize { base.drag_to(node.base) } self end |
#evaluate_async_script(script, *args) ⇒ Object
Evaluate the given JavaScript in the context of the element and obtain the result from a callback function which will be passed as the last argument to the script. ‘this` in the script will refer to the element this is called on
416 417 418 419 420 421 422 |
# File 'lib/capybara/node/element.rb', line 416 def evaluate_async_script(script, *args) session.evaluate_async_script(<<~JS, self, *args) (function (){ #{script} }).apply(arguments[0], Array.prototype.slice.call(arguments,1)); JS end |
#evaluate_script(script, *args) ⇒ Object
Evaluate the given JS in the context of the element and return the result. Be careful when using this with scripts that return complex objects, such as jQuery statements. execute_script
might be a better alternative. ‘this` in the script will refer to the element this is called on.
399 400 401 402 403 404 405 |
# File 'lib/capybara/node/element.rb', line 399 def evaluate_script(script, *args) session.evaluate_script(<<~JS, self, *args) (function(){ return #{script.strip} }).apply(arguments[0], Array.prototype.slice.call(arguments,1)); JS end |
#execute_script(script, *args) ⇒ Object
Execute the given JS in the context of the element not returning a result. This is useful for scripts that return complex objects, such as jQuery statements. execute_script
should be used over evaluate_script
whenever possible. ‘this` in the script will refer to the element this is called on.
382 383 384 385 386 387 388 |
# File 'lib/capybara/node/element.rb', line 382 def execute_script(script, *args) session.execute_script(<<~JS, self, *args) (function (){ #{script} }).apply(arguments[0], Array.prototype.slice.call(arguments,1)); JS end |
#hover ⇒ Capybara::Node::Element
Hover on the Element
260 261 262 263 |
# File 'lib/capybara/node/element.rb', line 260 def hover synchronize { base.hover } self end |
#inspect ⇒ Object
436 437 438 439 440 441 442 443 444 |
# File 'lib/capybara/node/element.rb', line 436 def inspect %(#<Capybara::Node::Element tag="#{base.tag_name}" path="#{base.path}">) rescue NotSupportedByDriverError %(#<Capybara::Node::Element tag="#{base.tag_name}">) rescue StandardError => e raise unless session.driver.invalid_element_errors.any? { |et| e.is_a?(et) } %(Obsolete #<Capybara::Node::Element>) end |
#multiple? ⇒ Boolean
Whether or not the element supports multiple results.
330 331 332 |
# File 'lib/capybara/node/element.rb', line 330 def multiple? synchronize { base.multiple? } end |
#native ⇒ Object
Returns The native element from the driver, this allows access to driver specific methods.
40 41 42 |
# File 'lib/capybara/node/element.rb', line 40 def native synchronize { base.native } end |
#path ⇒ String
An XPath expression describing where on the page the element can be found
340 341 342 |
# File 'lib/capybara/node/element.rb', line 340 def path synchronize { base.path } end |
#readonly? ⇒ Boolean
Whether or not the element is readonly.
320 321 322 |
# File 'lib/capybara/node/element.rb', line 320 def readonly? synchronize { base.readonly? } end |
#reload ⇒ Object
424 425 426 427 428 429 430 431 432 433 434 |
# File 'lib/capybara/node/element.rb', line 424 def reload if @allow_reload begin reloaded = query_scope.reload.first(@query.name, @query.locator, @query.) @base = reloaded.base if reloaded rescue StandardError => e raise e unless catch_error?(e) end end self end |
#right_click(*modifier_keys, **offset) ⇒ Capybara::Node::Element
Right Click the Element
Both x: and y: must be specified if an offset is wanted, if not specified the click will occur at the middle of the element
163 164 165 166 |
# File 'lib/capybara/node/element.rb', line 163 def right_click(*keys, **offset) synchronize { base.right_click(keys, offset) } self end |
#select_option ⇒ Capybara::Node::Element
Select this node if is an option element inside a select tag
125 126 127 128 129 |
# File 'lib/capybara/node/element.rb', line 125 def select_option warn "Attempt to select disabled option: #{value || text}" if disabled? synchronize { base.select_option } self end |
#selected? ⇒ Boolean
Whether or not the element is selected.
300 301 302 |
# File 'lib/capybara/node/element.rb', line 300 def selected? synchronize { base.selected? } end |
#send_keys(keys, ...) ⇒ Capybara::Node::Element
Send Keystrokes to the Element
Examples:
element.send_keys "foo" #=> value: 'foo'
element.send_keys "tet", :left, "s" #=> value: 'test'
element.send_keys [:control, 'a'], :space #=> value: ' ' - assuming ctrl-a selects all contents
Symbols supported for keys :cancel :help :backspace :tab :clear :return :enter :shift :control :alt :pause :escape :space :page_up :page_down :end :home :left :up :right :down :insert :delete :semicolon :equals :numpad0 :numpad1 :numpad2 :numpad3 :numpad4 :numpad5 :numpad6 :numpad7 :numpad8 :numpad9 :multiply - numeric keypad * :add - numeric keypad + :separator - numeric keypad ‘separator’ key ?? :subtract - numeric keypad - :decimal - numeric keypad . :divide - numeric keypad / :f1 :f2 :f3 :f4 :f5 :f6 :f7 :f8 :f9 :f10 :f11 :f12 :meta :command - alias of :meta
250 251 252 253 |
# File 'lib/capybara/node/element.rb', line 250 def send_keys(*args) synchronize { base.send_keys(*args) } self end |
#set(value, **options) ⇒ Capybara::Node::Element
Set the value of the form element to the given value.
113 114 115 116 117 118 |
# File 'lib/capybara/node/element.rb', line 113 def set(value, **) raise Capybara::ReadOnlyElementError, "Attempt to set readonly element with value: #{value}" if readonly? = ..to_h.merge() synchronize { base.set(value, ) } self end |
#style(*styles) ⇒ Hash
Retrieve the given CSS styles
element.style('color', 'font-size') # => Computed values of CSS 'color' and 'font-size' styles
83 84 85 86 87 88 89 90 91 92 93 94 95 |
# File 'lib/capybara/node/element.rb', line 83 def style(*styles) styles = styles.flatten.map(&:to_s) raise ArgumentError, 'You must specify at least one CSS style' if styles.empty? begin synchronize { base.style(styles) } rescue NotImplementedError => e begin evaluate_script(STYLE_SCRIPT, *styles) rescue Capybara::NotSupportedByDriverError raise e end end end |
#tag_name ⇒ String
Returns The tag name of the element.
269 270 271 |
# File 'lib/capybara/node/element.rb', line 269 def tag_name synchronize { base.tag_name } end |
#text(type = nil) ⇒ String
Retrieve the text of the element. If ‘Capybara.ignore_hidden_elements` is `true`, which it is by default, then this will return only text which is visible. The exact semantics of this may differ between drivers, but generally any text within elements with `display:none` is ignored. This behaviour can be overridden by passing `:all` to this method.
56 57 58 59 |
# File 'lib/capybara/node/element.rb', line 56 def text(type = nil) type ||= :all unless .ignore_hidden_elements || .visible_text_only synchronize { type == :all ? base.all_text : base.visible_text } end |
#trigger(event) ⇒ Capybara::Node::Element
Trigger any event on the current element, for example mouseover or focus events. Does not work in Selenium.
352 353 354 355 |
# File 'lib/capybara/node/element.rb', line 352 def trigger(event) synchronize { base.trigger(event) } self end |
#unselect_option ⇒ Capybara::Node::Element
Unselect this node if is an option element inside a multiple select tag
136 137 138 139 |
# File 'lib/capybara/node/element.rb', line 136 def unselect_option synchronize { base.unselect_option } self end |
#value ⇒ String
Returns The value of the form element.
101 102 103 |
# File 'lib/capybara/node/element.rb', line 101 def value synchronize { base.value } end |
#visible? ⇒ Boolean
Whether or not the element is visible. Not all drivers support CSS, so the result may be inaccurate.
280 281 282 |
# File 'lib/capybara/node/element.rb', line 280 def visible? synchronize { base.visible? } end |