Method: Selenium::WebDriver::SearchContext#find_element

Defined in:
lib/selenium/webdriver/common/search_context.rb

#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:


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

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.to_s, ref
rescue Selenium::WebDriver::Error::TimeoutError
  # Implicit Wait times out in Edge
  raise Selenium::WebDriver::Error::NoSuchElementError
end