---
version: "2026.1.0"
language: "en"
---
# Get Electron Text

The **Get Electron Text** block fetches text from a specified **Electron element** . If the element cannot be found within the configured timeout behavior, the block triggers **Not found**, which can be used to branch the flow.

Fully expanded, the **Get Electron Text** block shows the following properties:  
![image-20260202-171537.png](https://docs.leapwork.com/__attachments/a_c86c9432074693d932b69102e981b4a03d824ddea911f1f2d588cc744dd948a2/image-20260202-171537.png?cb=ba4f6de09208252ed82035051e5027b7)

**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 **Get Electron Text** onto the canvas.

2. Connect the block in the flow and specify **Select Electron Element to get text** (required). Optionally set **Find format** , **Filter** , and selection settings such as **Use occurred** . If needed, set **Source element** and **Electron window** to limit where the block searches.

3. Run the flow when it's ready.

## Building block parameters

Parameters  
* **Block header** : The green input connector triggers this block to begin execution. The green output connector is triggered when the Electron text is successfully fetched. You can rename the block by double-clicking the header text and typing in a new title.

* **Select Electron Element to get text** : **Required.** Contains the locator for the Electron element from which the text is extracted. Capture a locator by right-clicking the property and selecting **Capture new Electron text** . Clear the locator by right-clicking and selecting **Clear Electron text**.

* **Text found** : Outputs the text that was retrieved from the Electron element.

* **Not found** : Triggers if the Electron element is not found before the timeout behavior completes. This is typically used to branch the execution flow or explicitly fail a case by linking it to a **Fail** block.

* **Position found** : Outputs the application canvas position where the Electron element was found as **X, Y** coordinates. The top-left corner of the application canvas is **0, 0** .

* **Area found** : Outputs the application canvas position and size of the found Electron element as **X, Y, Width, Height** , starting with the upper-leftmost pixel. The top-left corner of the screen is **0, 0** .

* **Source element** : Limits the Electron element locator to only work inside the specified source element when you choose the **Element** option. This is useful when you want the locator to search within a specific region or parent element instead of the full window.

* **Electron window** : Contains a handle to the Electron window once it is found and focused. Use this when multiple Electron windows are open to direct the block to fetch text from a specific window.

* **Find format** : Defines a format the text must match in order to be retrieved. For example, with a format like `Status: [TEXT] today`, only the text inside strings such as `Status: Green Mode today` is returned.

* **Is case sensitive** : Controls whether **Find format** matching is case sensitive. By default, matching is case insensitive.

* **Filter** : Applies an additional filter to the retrieved text. For example, you can filter to only retrieve numbers or only retrieve text that matches a specific pattern or rule.

* **Use occurred** : Selects which occurrence of the Electron element to use when more than one match is found. Select **All** to iterate through all occurrences.

* **Count** : Outputs the total number of found Electron elements that match the locator.

* **Default timeout** : Controls whether the block uses the default timeout from the flow settings or a custom timeout value.

* **Scroll to find** : Controls whether the block scrolls while searching for the Electron element. When a value other than **None** is selected, the block uses scrolling during the search.

* **Scroll into view** : When enabled, any found Electron element is automatically scrolled into view.

* **Await DOM change** : Delays the search until there have been no DOM changes 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 occurs 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 occurs after waiting a maximum of **30 seconds**.

## Resources

|                                                   **Topic**                                                   |                                                  **Description**                                                  |
|---------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------|
| [Flows FAQ](https://docs.leapwork.com/faq/latest/leapwork-flow-faq/flows-faq.md)                                                       | Common questions about creating, running, and managing flows in Leapwork.                                         |
| [Flows Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/flows-troubleshooting.md)       | Guidelines and solutions for identifying and fixing issues that occur when building or running flows in Leapwork. |
| [Electron Troubleshooting](https://docs.leapwork.com/troubleshooting/latest/leapwork-flow-troubleshooting/electron-troubleshooting.md) | Guidance and solutions for diagnosing and resolving issues related to Electron-based automation and environments  |