Method: Capybara::Node::Finders#all
- Defined in:
- lib/capybara/node/finders.rb
#all([kind = Capybara.default_selector], locator = nil, **options) ⇒ Capybara::Result #all([kind = Capybara.default_selector], locator = nil, **options) {|element| ... } ⇒ Capybara::Result Also known as: find_all
Find all elements on the page matching the given selector and options.
Both XPath and CSS expressions are supported, but Capybara does not try to automatically distinguish between them. The following statements are equivalent:
page.all(:css, 'a#person_123')
page.all(:xpath, './/a[@id="person_123"]')
If the type of selector is left out, Capybara uses
default_selector. It's set to :css
by default.
page.all("a#person_123")
Capybara.default_selector = :xpath
page.all('.//a[@id="person_123"]')
The set of found elements can further be restricted by specifying options. It's possible to select elements by their text or visibility:
page.all('a', text: 'Home')
page.all('#menu li', visible: true)
By default Capybara's waiting behavior will wait up to default_max_wait_time seconds for matching elements to be available and then return an empty result if none are available. It is possible to set expectations on the number of results located and Capybara will raise an exception if the number of elements located don't satisfy the specified conditions. The expectations can be set using:
page.assert_selector('p#foo', count: 4)
page.assert_selector('p#foo', maximum: 10)
page.assert_selector('p#foo', minimum: 1)
page.assert_selector('p#foo', between: 1..10)
If the driver is capable of executing JavaScript, this method will wait for a set amount of time and continuously retry finding the element until either the element is found or the time expires. The length of time this method will wait is controlled through default_max_wait_time.
257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 |
# File 'lib/capybara/node/finders.rb', line 257 def all(*args, allow_reload: false, **, &optional_filter_block) minimum_specified = () = { minimum: 1 }.merge() unless minimum_specified [:session_options] = query = Capybara::Queries::SelectorQuery.new(*args, **, &optional_filter_block) result = nil begin synchronize(query.wait) do result = query.resolve_for(self) result.allow_reload! if allow_reload raise Capybara::ExpectationNotMet, result. unless result.matches_count? result end rescue Capybara::ExpectationNotMet raise if minimum_specified || (result.compare_count == 1) Result.new([], nil) end end |