Module: Selenium::WebDriver::SearchContext

Included in:
Driver, Element, ShadowRoot
Defined in:
rb/lib/selenium/webdriver/common/search_context.rb

Constant Summary collapse

FINDERS =

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

{
  class: 'class name',
  class_name: 'class name',
  css: 'css selector',
  id: 'id',
  link: 'link text',
  link_text: 'link text',
  name: 'name',
  partial_link_text: 'partial link text',
  relative: 'relative',
  tag_name: 'tag name',
  xpath: 'xpath'
}.freeze

Instance Method Summary collapse

Instance Method Details

#find_element(how, what) ⇒ Element #find_element(opts) ⇒ Element

Find the first element matching the given arguments

When using Element#find_element with :xpath, be aware that webdriver follows standard conventions: a search prefixed with “//” will search the entire document, not just the children of this current node. Use “.//” to limit your search to the children of the receiving Element.

Overloads:

  • #find_element(how, what) ⇒ Element

    Parameters:

    • how (Symbol, String) —

      The method to find the element by

    • what (String) —

      The locator to use

  • #find_element(opts) ⇒ Element

    Parameters:

    • opts (Hash) —

      Find options

    Options Hash (opts):

    • :how (Symbol) —

      Key named after the method to find the element by, containing the locator

Returns:

Raises:



57
58
59
60
61
62
63
64
 
# File 'rb/lib/selenium/webdriver/common/search_context.rb', line 57

def find_element(*args)
  how, what = extract_args(args)

  by = FINDERS[how.to_sym]
  raise ArgumentError, "cannot find element by #{how.inspect}" unless by

  bridge.find_element_by by, what, ref
end

#find_elements(*args) ⇒ Object

Find all elements matching the given arguments

Raises:

  • (ArgumentError)

See Also:



72
73
74
75
76
77
78
79
 
# File 'rb/lib/selenium/webdriver/common/search_context.rb', line 72

def find_elements(*args)
  how, what = extract_args(args)

  by = FINDERS[how.to_sym]
  raise ArgumentError, "cannot find elements by #{how.inspect}" unless by

  bridge.find_elements_by by, what, ref
end