Hover Electron Element

The Hover Electron Element building block hovers the mouse over a specified Electron element in an application window.

Fully expanded, the Hover Electron Element block shows the following properties:

image-20260205-133659.png

Note: The screenshot on this page uses the Elegance Design, introduced in 2025.3. If you are using an earlier version, your layout may look different.

Quick-start

  1. Drag Hover Electron Element onto the canvas.

  2. Connect the block in the flow and select the Electron element to hover in Select Electron Element to hover (capture an element). Optionally, adjust other parameters if needed

  3. Run the flow when it’s ready.

Building block parameters

Parameters
  • Block header: The green input connector triggers the block to begin execution. The green output connector triggers when an Electron element is successfully hovered over. You can rename the block by double-clicking the header text and typing a new title.

  • Select Electron Element to hover: Contains the locator for the Electron element to hover. You can capture a locator by right-clicking and selecting Capture new Electron element, and you can remove it by right-clicking and selecting Clear Electron element.

  • Found element: Contains the Electron element that was found in the application window. You can use it as a source element in other building blocks to narrow down later element searches (for example, when targeting table cells).

  • Not found: Triggers if the Electron element is not found before the timeout. This is typically used to branch the flow or to fail a case by connecting it to a Fail block.

  • Position found: The application canvas position where the element was found, in X, Y coordinates (top-left of the application canvas is 0, 0).

  • Area found: The position and size of the found element in X, Y, Width, Height coordinates, starting at the element’s upper-left pixel.

  • Attributes: A list of all attributes on the found element as key–value pairs, including standard HTML attributes (for example class, style, href) and custom attributes (for example data-xxx). For direct attribute lookup, the Get Electron Attribute building block is recommended.

  • CSS values: Currently unused.

  • Visible: Returns True if the found Electron element is visible.

  • Tag name: The tag name of the found Electron element (for example div, tr, button, or input).

  • Source element: Lets you limit the locator to only search inside a specific source element by selecting the Element option, so the locator applies within that source element rather than the whole window.

  • Electron window: Contains a handle to the Electron window once a window has been found and focus is set. This can be used to direct other building blocks to a specific window when multiple windows are open.

  • Use occurred: Selects which occurrence of the Electron element to use when multiple matches are found. Select All to iterate through all occurrences.

  • Count: Contains the total number of found Electron elements that match the locator.

  • Default timeout: Controls whether the block uses the flow’s default timeout or a fixed timeout. If the checkbox is not selected, the timeout is 10 seconds unless changed manually. If the checkbox is selected, the flow’s Default timeout under Max. run time applies.

  • Scroll to find: When set to a value other than None, the block uses scrolling while searching for the Electron element.

  • Require valid images: When selected, any Electron element locator that targets an image (img tag) also verifies that the image loads correctly.

  • Await DOM change: Delays the search until there have been no changes to the application’s DOM for a specified period (for example, three seconds). This is useful when waiting for behind-the-scenes JavaScript updates. Regardless of this checkbox, the search proceeds after waiting a maximum of 30 seconds.

  • Await Requests: Delays the search until there have been no active XHR requests for a specified period (for example, three seconds). Regardless of this checkbox, the search proceeds after waiting a maximum of 30 seconds.

Resources

Topic

Description

Flows FAQ

Common questions about creating, running, and managing flows in Leapwork.

Flows Troubleshooting

Guidelines and solutions for identifying and fixing issues that occur when building or running flows in Leapwork.

Electron Troubleshooting

Guidance and solutions for diagnosing and resolving issues related to Electron-based automation and environments