Class: Capybara::Node::Element

Inherits:

Base

• Object
• Base
• Capybara::Node::Element

show all

Defined in:

lib/capybara/node/element.rb

Overview

session = Capybara::Session.new(:rack_test, my_app)

bar = session.find('#bar')              # from Capybara::Node::Finders
bar.select('Baz', :from => 'Quox')      # from Capybara::Node::Actions

bar.value
bar.text
bar[:title]

Instance Attribute Summary

Attributes inherited from Base

#base, #parent, #session

Instance Method Summary (collapse)

• - (String) [](attribute)

  Retrieve the given attribute.

• - (Object) all(*args)
• - (Boolean) checked?

  Whether or not the element is checked.

• - (Object) click

  Click the Element.

• - (Object) drag_to(node)

  Drag the element to the given other element.

• - (Object) find(*args)
• - (Object) first(*args)
• - (Element) initialize(session, base, parent, selector) constructor

  A new instance of Element.

• - (Object) inspect
• - (Object) native

  The native element from the driver, this allows access to driver specific methods.

• - (String) path

  An XPath expression describing where on the page the element can be found.

• - (Object) reload
• - (Object) select_option

  Select this node if is an option element inside a select tag.

• - (Boolean) selected?

  Whether or not the element is selected.

• - (Object) set(value)

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

• - (String) tag_name

  The tag name of the element.

• - (String) text

  The text of the element.

• - (Object) trigger(event)

  Trigger any event on the current element, for example mouseover or focus events.

• - (Object) unselect_option

  Unselect this node if is an option element inside a multiple select tag.

• - (String) value

  The value of the form element.

• - (Boolean) visible?

  Whether or not the element is visible.

Methods inherited from Base

#synchronize

Methods included from Matchers

#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_table?, #has_text?, #has_unchecked_field?, #has_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

#find_button, #find_by_id, #find_field, #find_link, #query, #resolve

25
26
27
28
29

# File 'lib/capybara/node/element.rb', line 25

def initialize(session, base, parent, selector)
  super(session, base)
  @parent = parent
  @selector = selector
end

element[:title] # => HTML title attribute

56
57
58

# File 'lib/capybara/node/element.rb', line 56

def [](attribute)
  synchronize { base[attribute] }
end

184
185
186

# File 'lib/capybara/node/element.rb', line 184

def all(*args)
  synchronize { super }
end

127
128
129

# File 'lib/capybara/node/element.rb', line 127

def checked?
  synchronize { base.checked? }
end

98
99
100

# File 'lib/capybara/node/element.rb', line 98

def click
  synchronize { base.click }
end

source = page.find('#foo')
target = page.find('#bar')
source.drag_to(target)

172
173
174

# File 'lib/capybara/node/element.rb', line 172

def drag_to(node)
  synchronize { base.drag_to(node.base) }
end

176
177
178

# File 'lib/capybara/node/element.rb', line 176

def find(*args)
  synchronize { super }
end

180
181
182

# File 'lib/capybara/node/element.rb', line 180

def first(*args)
  synchronize { super }
end

194
195
196
197
198

# File 'lib/capybara/node/element.rb', line 194

def inspect
  %(#<Capybara::Element tag="#{tag_name}" path="#{path}">)
rescue NotSupportedByDriverError
  %(#<Capybara::Element tag="#{tag_name}">)
end

35
36
37

# File 'lib/capybara/node/element.rb', line 35

def native
  synchronize { base.native }
end

147
148
149

# File 'lib/capybara/node/element.rb', line 147

def path
  synchronize { base.path }
end

188
189
190
191
192

# File 'lib/capybara/node/element.rb', line 188

def reload
  reloaded = parent.reload.first(@selector.name, @selector.locator, @selector.options)
  @base = reloaded.base if reloaded
  self
end

82
83
84

# File 'lib/capybara/node/element.rb', line 82

def select_option
  synchronize { base.select_option }
end

137
138
139

# File 'lib/capybara/node/element.rb', line 137

def selected?
  synchronize { base.selected? }
end

74
75
76

# File 'lib/capybara/node/element.rb', line 74

def set(value)
  synchronize { base.set(value) }
end

106
107
108

# File 'lib/capybara/node/element.rb', line 106

def tag_name
  synchronize { base.tag_name }
end

43
44
45

# File 'lib/capybara/node/element.rb', line 43

def text
  synchronize { base.text }
end

158
159
160

# File 'lib/capybara/node/element.rb', line 158

def trigger(event)
  synchronize { base.trigger(event) }
end

90
91
92

# File 'lib/capybara/node/element.rb', line 90

def unselect_option
  synchronize { base.unselect_option }
end

64
65
66

# File 'lib/capybara/node/element.rb', line 64

def value
  synchronize { base.value }
end

117
118
119

# File 'lib/capybara/node/element.rb', line 117

def visible?
  synchronize { base.visible? }
end