Find Elements

This Node Is Deprecated — This version of the node has been replaced with a new and improved version. The old version is kept for backwards-compatibility, but for all new workflows we suggest to use the version linked below.
Go to Suggested ReplacementFind Elements

Extracts WebElements based on different criteria. The input can either be a WebDriver (representing a browser's window), or a WebElement (a subpart of the window). The following search criteria are available:

Find by Explanation
className Finds elements based on their class attributes. In case an element has multiple class values assigned, matching a single value is sufficient.
cssSelector Finds elements based on a CSS selector expression.
id Finds an element based in its id attribute.
linkText Finds links through an exact match of their text.
name Finds elements based on their name attributes.
partialLinkText Finds links by a partial match of the given text.
tagName Finds elements based on their tag names.
xpath Finds elements based on an XPath expression.

For each extracted WebElement a new row is added to the output table.

Note that you cannot only search within the given input, but also navigate the entire DOM tree. For example, you can use the XPath query .. to find a WebElement's parent.

In case you need to extract an element which is not immediately available on the page, consider specifying an Implicit wait within the Start WebDriver's Timeouts options.

Options

Input
The input column providing the starting point where to search.
Find by
The search criteria (see above).
Query
The query.
Extract only first match
If enabled, extract only first match per input row instead of all.
Append additional WebElement information
If enabled, additional columns with the WebElement's properties are appended (tag name, text content, selected, enabled, displayed state, position and size). This may (1) slow down extraction or (2) not be supported by specific WebDriver implementations, in latter case MissingValues will be returned.
Explicit wait
The amount of time to wait in case elements are searched and are not immediately available.
Catch exceptions
Do not fail the node's execution in case an exception is encountered (typically, in case the explicit wait timeout was reached without finding an element).

Input Ports

Icon
Table with a column providing a WebDriver or WebElements in which to search

Output Ports

Icon
Table with the found WebElements (and optionally additional columns with more information)

Popular Predecessors

Views

This node has no views

Workflows

Links

Developers

You want to see the source code for this node? Click the following button and we’ll use our super-powers to find it for you.