module Selenium::WebDriver::SearchContext
Constants
- FINDERS
-
@api private
Attributes
Public Class Methods
Source
# File lib/selenium/webdriver/common/search_context.rb, line 41 def finders FINDERS.merge(extra_finders || {}) end
Public Instance Methods
Source
# File lib/selenium/webdriver/common/search_context.rb, line 65 def find_element(*args) how, what = extract_args(args) by = SearchContext.finders[how.to_sym] raise ArgumentError, "cannot find element by #{how.inspect}" unless by bridge.find_element_by by, what, ref end
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
.
@overload find_element
(how, what)
@param [Symbol, String] how The method to find the element by @param [String] what The locator to use
@overload find_element
(opts)
@param [Hash] opts Find options @option opts [Symbol] :how Key named after the method to find the element by, containing the locator
@return [Element]
@raise [Error::NoSuchElementError] if the element doesn’t exist
Source
# File lib/selenium/webdriver/common/search_context.rb, line 80 def find_elements(*args) how, what = extract_args(args) by = SearchContext.finders[how.to_sym] raise ArgumentError, "cannot find elements by #{how.inspect}" unless by bridge.find_elements_by by, what, ref end
Find all elements matching the given arguments
Private Instance Methods
Source
# File lib/selenium/webdriver/common/search_context.rb, line 91 def extract_args(args) case args.size when 2 args when 1 arg = args.first unless arg.respond_to?(:shift) raise ArgumentError, "expected #{arg.inspect}:#{arg.class} to respond to #shift" end # this will be a single-entry hash, so use #shift over #first or #[] arr = arg.dup.shift raise ArgumentError, "expected #{arr.inspect} to have 2 elements" unless arr.size == 2 arr else raise ArgumentError, "wrong number of arguments (#{args.size} for 2)" end end