Browser Action

The Browser Action field types allow you to automate and control various browser tab operations within your project. These field types enable you to open new tabs, retrieve tab IDs, capture screenshots, update tab properties, close tabs, and perform other browser-related actions.

Open a new Tab

Open a new tab in browser then use this field type and you can set tab url in the field value or default value.

---

Get Tab ID

This field type retrieves the ID of a specific tab within the browser. It allows you to identify the desired tab using various matching methods.

Options	Description
Which type of match you want to use?	Choose the matching method for identifying the tab:
	- By Tab URL and Title: Match using both URL and title criteria
	- By Tab Index: Match using the tab's position index
	- Active Tab: Target the currently active tab
Tab Index	Specify the tab's position index (only used when "By Tab Index" is selected).
Which URL match pattern you want to use?	Choose the URL matching pattern:
	- Default Browser Match Patterns: Use Chrome extension match patterns, More Details
	- Use with Regex: Use regular expressions with (:any), (:any(:end)) for dynamic matching More Details
Tab URL	Specify the URL of the tab you want to identify.
Should we use tab title for matching?	Enable this option to include tab title in the matching criteria.
Wait until the tab url or title matches?	Enable this option to make the field wait until the specified tab URL or title is found.
Should we use timeout (Set in Minutes)?	Set a maximum time limit (in minutes) to wait for the tab to be found.

Usage:

The field's value will be the ID of the identified tab. You can use this ID in other browser actions, such as Focus Tab, Close Browser Tab, or Reload Tab.

Note

• If multiple tabs match the specified criteria, the ID of the first matching tab will be returned.
• If no tab matches within the timeout limit, the field's value will be null.

---

Get Tab Details

This field type retrieves specific details about a browser tab. It allows you to extract various tab properties such as URL, title, favicon, index, and other tab attributes.

Options	Description
Which type of details you want to get?	Choose the specific tab property you want to retrieve:
	- Get Tab URL: Retrieve the URL of the specified tab
	- Get Tab Title: Retrieve the title of the specified tab
	- Get Tab Favicon URL: Retrieve the favicon URL of the specified tab
	- Get Tab Index: Retrieve the position index of the specified tab
	- Get Tab windowId: Retrieve the window ID that contains the specified tab
	- Get Tab Active?: Check if the specified tab is currently active (returns true/false)
	- Get Tab Incognito?: Check if the specified tab is in incognito mode (returns true/false)
	- Get Tab Pinned?: Check if the specified tab is pinned (returns true/false)
Tab Id	Enter the ID of the tab from which the data is to be extracted in the default value settings of the field.

Usage:

The field's value will contain the requested tab detail based on your selection. You can use this data in other fields like Download Item or for conditional logic in your automation flow.

Note

• If the specified tab ID is invalid or the tab no longer exists, the field's value will be null.
• The tab ID can be obtained using the "Get Tab ID" field type.

---

Capture Tab

If you want to take a screenshot of the page then you can use this.

INFO

Will capture the entire page if you are using Firefox browser.

Update Tab

Action on Active Tab.

• active
• autoDiscardable
• highlighted
• muted
• pinned
• url

Go Back to Previous Page

if element value is false then skip this action (also set tab id in the element value)

Go Forward to Next Page

if element value is false then skip this action (also set tab id in the element value)

Check Downloads

This field type allows you to monitor the status of download items in the browser. It provides a way to pause your automation flow until a specific download status is reached.

Options

Options	Description
Downloads Item Status	Specify the desired download item status you are waiting for. Choose from the following options:
	- Progress: The download is in progress.
	- Complete: The download is complete.
	- Broke Connection: The download has encountered a broken connection.
Wait until the download items stratus matches	This option determines whether the field waits until the specified download item status is reached. If unchecked, the field will simply report the current download item status without pausing execution.

Usage

1. Set the desired download item status. Choose from the available options: Progress, Complete, or Broke Connection.
2. Optionally, enable the "Wait until the download items status matches" option. This will pause the automation flow until the specified status is reached.

Example

If you want to wait for a specific download to complete, configure the field as follows:

• Downloads Item Status: Complete
• Wait until the download items stratus matches: Checked

Reload Tab

if element value is false then skip this action (also set tab id in the element value)

Focus Tab

It is used to focus the browser's tab.

Options	Description	Required
Field Value	- If field value is empty then focus active tab. - If field value is false then skip focus tab action. - You can also set the Tab Id in the field value.	No

Focus Window

It is used to focus the browser's window.

Options	Description	Required
Field Value	- If field value is empty then focus active window. - If field value is false then skip focus window action. - You can also set the Window Id in the field value.	No

Close Browser Tab

This field type can be used to close the browser Tab.

Options	Description
Match the tab with the tab title and tab URL and then close it?	Enable this option to match and close a tab based on URL and title criteria.
Tab URL	Specify the URL of the tab you want to close.
Tab Title	Specify the title of the tab you want to close.
Timeout	Set a maximum time limit (in minutes) to wait for the tab to be found.
Wait until the tab url or title matches?	Enable this option to make the field wait until the specified tab URL or title is found before closing.
Close the active tab only?	Enable this option to close only the currently active tab.

Field Value	if field value is empty then close active tab. if field value is false then skip close tab action. You can also set the Tab Id in the field value.

NOTE

Whichever tab you want to close, enter Tab id in the field default value. If no Tab ID is given then that tab will be closed in which form this field is present.

Close Browser Window

This field type can be used to close the browser Window.

Options	Description	Required
Field Value	- If field value is empty then close active window. - If field value is false then skip close window action. - You can also set the Window Id in the field value.	No

Set Download Item File Name

If you want to change the name of the file being downloaded in the browser, then use it before clicking on the download button.

Field Value	File Name: fileName File Name with Folder: foldername\fileName Variable with Folder: foldername\{$predefine_variable$} ⚠️ You do not have to give the full path of the folder (D:\Excel), you can only give the name of any folder in the Download Folder of the PC.
Ways to save the file?	Uniquify : If you want to save the file with a unique name Overwrite : If you want to overwrite the file

WARNING

This field type only uses single file rename at a time, does not work on multiple tabs and multiple files.

Download Item

This field type allows you to download files from URLs with various download options and file handling preferences.

Options	Description
Which type of downloader you want to use?	Choose the download method:
	- Use Chrome Downloader: Use the browser's built-in download functionality
	- Use Download Yourself: Handle the download process manually
What to do if the file already exists?	Choose how to handle existing files:
	- Uniquify: Add a unique identifier to the filename to avoid conflicts
	- Replace: Overwrite the existing file
	- Prompt for User: Ask the user to choose what to do
Use a file-chooser to allow the user to choose a filename?	Enable this option to show a file dialog for the user to select the download location and filename.
Set the file name	Specify the desired filename for the downloaded file.
File URL	Enter the URL of the item to be downloaded in the default value settings of the field.

Usage:

This field type initiates a download process for the specified URL. The download behavior depends on your selected options for downloader type, file conflict handling, and filename settings.

Note

• The File URL should be a direct download link to the file you want to download.
• If using "Use Download Yourself", ensure the URL is accessible and the file is downloadable.
• File conflict resolution options help manage scenarios where files with the same name already exist.

Important

You must Allow the site permission Automatic downloads for this field type to work.

How to open site permission?

chrome://settings/content/siteDetails?site=(YOUR_SITE_URL)

---

Insert CSS

Inserts a CSS stylesheet into page. You can set css in the field value or default value.

Set Local Data

It is used to store any data in browser storage. The data is stored in a unique key. With this unique key you can Get/Fetch or Remove that data.

Options	Description
Store Key Name	Enter the unique key name to store the data. Use prefix CTH_EDF_DB_LOCAL_ for consistency.
Data Value	Enter the data you want to store in the browser storage.

Usage

1. Set Store Key Name: Enter a unique key name with the recommended prefix CTH_EDF_DB_LOCAL_
2. Set Data Value: Enter the data you want to store (text, variables, etc.)
3. Store Data: The data will be stored in browser storage and can be retrieved later

Example

• Store Key Name: CTH_EDF_DB_LOCAL_user_email
• Data Value: [email protected]

---

Get Local Data

We can fetch the data stored through Set Local Data through the unique key of that data.

Options	Description
Store Key Name	Enter the unique key name to fetch the stored data. Use prefix CTH_EDF_DB_LOCAL_ for consistency.
Wait until the given key data is received	Enable this option to wait until the specified key data is available before proceeding.
Delete the data after getting the key data	Enable this option to automatically delete the data after retrieving it (one-time use).

Usage

1. Set Store Key Name: Enter the key name that was used when storing the data with "Set Local Data"
2. Wait for Data: Enable "Wait until the given key data is received" if the data might not be immediately available
3. One-time Use: Enable "Delete the data after getting the key data" if you only need to use the data once

Example

• Store Key Name: CTH_EDF_DB_LOCAL_user_profile
• Wait until the given key data is received: ✅ Enabled
• Delete the data after getting the key data: ❌ Disabled (keep data for reuse)

---

Remove Local Data

We can delete the data stored through Set Local Data through the unique key of that data.

Options	Description
Store Key Name	Enter the unique key name of the data you want to delete. Use prefix CTH_EDF_DB_LOCAL_ for consistency.

Usage

1. Set Store Key Name: Enter the exact key name that was used when storing the data with "Set Local Data"
2. Remove Data: The data associated with that key will be permanently deleted from browser storage

Example

• Store Key Name: CTH_EDF_DB_LOCAL_user_profile
• Result: The user profile data will be permanently removed from browser storage