Class: Selenium::WebDriver::Element

Inherits:
Object
  • Object
show all
Includes:
SearchContext
Defined in:
lib/selenium/webdriver/common/element.rb

Constant Summary

Constants included from SearchContext

SearchContext::FINDERS

Instance Method Summary collapse

Methods included from SearchContext

#find_element, #find_elements

Constructor Details

#initialize(bridge, id) ⇒ Element

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Creates a new Element



31
32
33
34
# File 'lib/selenium/webdriver/common/element.rb', line 31

def initialize(bridge, id)
  @bridge = bridge
  @id = id
end

Instance Method Details

#==(other) ⇒ Object Also known as: eql?



40
41
42
# File 'lib/selenium/webdriver/common/element.rb', line 40

def ==(other)
  other.is_a?(self.class) && ref == other.ref
end

#as_jsonObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

For Rails 3 - jonathanjulian.com/2010/04/rails-to_json-or-as_json/



314
315
316
317
318
319
320
321
# File 'lib/selenium/webdriver/common/element.rb', line 314

def as_json(*)
  key = if bridge.dialect == :w3c
          'element-6066-11e4-a52e-4f735466cecf'
        else
          'ELEMENT'
        end
  @id.is_a?(Hash) ? @id : {key => @id}
end

#attribute(name) ⇒ String? Also known as: []

Get the value of a the given attribute of the element. Will return the current value, even if this has been modified after the page has been loaded. More exactly, this method will return the value of the given attribute, unless that attribute is not present, in which case the value of the property with the same name is returned. If neither value is set, nil is returned. The “style” attribute is converted as best can be to a text representation with a trailing semi-colon. The following are deemed to be “boolean” attributes, and will return either “true” or “false”:

async, autofocus, autoplay, checked, compact, complete, controls, declare, defaultchecked, defaultselected, defer, disabled, draggable, ended, formnovalidate, hidden, indeterminate, iscontenteditable, ismap, itemscope, loop, multiple, muted, nohref, noresize, noshade, novalidate, nowrap, open, paused, pubdate, readonly, required, reversed, scoped, seamless, seeking, selected, spellcheck, truespeed, willvalidate

Finally, the following commonly mis-capitalized attribute/property names are evaluated as expected:

class, readonly

Parameters:

  • name (String)

    attribute name

Returns:

  • (String, nil)

    attribute value



115
116
117
# File 'lib/selenium/webdriver/common/element.rb', line 115

def attribute(name)
  bridge.element_attribute self, name
end

#clearObject

If this element is a text entry element, this will clear the value. Has no effect on other elements. Text entry elements are INPUT and TEXTAREA elements.

Note that the events fired by this event may not be as you'd expect. In particular, we don't fire any keyboard or mouse events. If you want to ensure keyboard events are fired, consider using #send_keys with the backspace key. To ensure you get a change event, consider following with a call to #send_keys with the tab key.



170
171
172
# File 'lib/selenium/webdriver/common/element.rb', line 170

def clear
  bridge.clear_element @id
end

#clickObject

Click this element. If this causes a new page to load, this method will attempt to block until the page has loaded. At this point, you should discard all references to this element and any further operations performed on this element will raise a StaleElementReferenceError unless you know that the element and the page will still be present. If click() causes a new page to be loaded via an event or is done by sending a native event then the method will not wait for it to be loaded and the caller should verify that a new page has been loaded.

There are some preconditions for an element to be clicked. The element must be visible and it must have a height and width greater then 0.

Equivalent to:

driver.action.click(element)

Examples:

Click on a button


driver.find_element(tag_name: "button").click

Raises:

  • (StaleElementReferenceError)

    if the element no longer exists as defined



73
74
75
# File 'lib/selenium/webdriver/common/element.rb', line 73

def click
  bridge.click_element @id
end

#css_value(prop) ⇒ Object Also known as: style

Get the value of the given CSS property

Note that shorthand CSS properties (e.g. background, font, border, border-top, margin, margin-top, padding, padding-top, list-style, outline, pause, cue) are not returned, in accordance with the DOM CSS2 specification - you should directly access the longhand properties (e.g. background-color) to access the desired values.



223
224
225
# File 'lib/selenium/webdriver/common/element.rb', line 223

def css_value(prop)
  bridge.element_value_of_css_property @id, prop
end

#displayed?Boolean

Is the element displayed?

Returns:

  • (Boolean)


200
201
202
# File 'lib/selenium/webdriver/common/element.rb', line 200

def displayed?
  bridge.element_displayed? @id
end

#enabled?Boolean

Is the element enabled?

Returns:

  • (Boolean)


180
181
182
# File 'lib/selenium/webdriver/common/element.rb', line 180

def enabled?
  bridge.element_enabled? @id
end

#hashObject



45
46
47
# File 'lib/selenium/webdriver/common/element.rb', line 45

def hash
  @id.hash ^ @bridge.hash
end

#inspectObject



36
37
38
# File 'lib/selenium/webdriver/common/element.rb', line 36

def inspect
  format '#<%s:0x%x id=%s>', self.class, hash * 2, @id.inspect
end

#locationWebDriver::Point

Get the location of this element.

Returns:



234
235
236
# File 'lib/selenium/webdriver/common/element.rb', line 234

def location
  bridge.element_location @id
end

#location_once_scrolled_into_viewWebDriver::Point

Determine an element's location on the screen once it has been scrolled into view.

Returns:



254
255
256
# File 'lib/selenium/webdriver/common/element.rb', line 254

def location_once_scrolled_into_view
  bridge.element_location_once_scrolled_into_view @id
end

#property(name) ⇒ String?

Get the value of a the given property with the same name of the element. If the value is not set, nil is returned.

Parameters:

  • name (String)

    property name

Returns:

  • (String, nil)

    property value



127
128
129
# File 'lib/selenium/webdriver/common/element.rb', line 127

def property(name)
  bridge.element_property self, name
end

#rectWebDriver::Rectangle

Get the dimensions and coordinates of this element.



244
245
246
# File 'lib/selenium/webdriver/common/element.rb', line 244

def rect
  bridge.element_rect @id
end

#refObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

for SearchContext and execute_script



293
294
295
# File 'lib/selenium/webdriver/common/element.rb', line 293

def ref
  @id
end

#selected?Boolean

Is the element selected?

Returns:

  • (Boolean)


190
191
192
# File 'lib/selenium/webdriver/common/element.rb', line 190

def selected?
  bridge.element_selected? @id
end

#send_keys(*args) ⇒ Object Also known as: send_key

Send keystrokes to this element

Examples:

element.send_keys "foo"                     #=> value: 'foo'
element.send_keys "tet", :arrow_left, "s"   #=> value: 'test'
element.send_keys [:control, 'a'], :space   #=> value: ' '

Parameters:

  • args (String, Symbol, Array)

    keystrokes to send

See Also:



155
156
157
# File 'lib/selenium/webdriver/common/element.rb', line 155

def send_keys(*args)
  bridge.send_keys_to_element @id, Keys.encode(args)
end

#sizeWebDriver::Dimension

Get the size of this element



264
265
266
# File 'lib/selenium/webdriver/common/element.rb', line 264

def size
  bridge.element_size @id
end

#submitObject

Submit this element



208
209
210
# File 'lib/selenium/webdriver/common/element.rb', line 208

def submit
  bridge.submit_element @id
end

#tag_nameString

Get the tag name of the element.

Examples:

Get the tagname of an INPUT element(returns “input”)


driver.find_element(xpath: "//input").tag_name

Returns:

  • (String)

    The tag name of this element.



87
88
89
# File 'lib/selenium/webdriver/common/element.rb', line 87

def tag_name
  bridge.element_tag_name @id
end

#textString

Get the text content of this element

Returns:

  • (String)


137
138
139
# File 'lib/selenium/webdriver/common/element.rb', line 137

def text
  bridge.element_text @id
end

#to_jsonObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Convert to a WebElement JSON Object for transmission over the wire.



304
305
306
# File 'lib/selenium/webdriver/common/element.rb', line 304

def to_json(*)
  JSON.generate as_json
end