Skip to main content

$$

The $$ command is a short and handy way in order to fetch multiple elements on the page. It returns a ChainablePromiseArray containing a set of WebdriverIO elements.

info

As opposed to the $$ attached to the browser object this command queries elements based on a root element.

You can chain $ or $$ together without wrapping individual commands into await in order to walk down the DOM tree, e.g.:

const imageSrc = await $$('div')[1].nextElement().$$('img')[2].getAttribute('src)

It is also possible to use async iterators to loop over the result of the query, e.g.:

// print all image sources
for await (const img of $$('img')) {
console.log(await img.getAttribute('src))
}
info

For more information on how to select specific elements, check out the Selectors guide.

Usage
$(selector).$$(selector)
Parameters
NameTypeDetails
selectorString, Function, Matcherselector, JS Function, or Matcher object to fetch multiple elements
Examples
example.html
loading...
multipleElements.js
loading...
multipleElements.js
loading...
multipleElements.js
loading...