Changelogs

Major

Global HTTP Request Headers:

• Added new commands to support setting custom headers on all outgoing browser requests:
  • TEST.setRequestHeader(name: string, value: string) - to set a single header
  • TEST.setRequestHeaders(headerMap: object) - to set multiple headers using a map
• You can get and delete the headers with these commands:
  • TEST.getRequestHeaders() - get all request headers as a map
  • TEST.getRequestHeader(name: string) - get the value of a single request header
  • TEST.clearRequestHeaders() - get all request headers as a map
  • TEST.deleteRequestHeader(name: string) - delete a single request header

Project Configuration:

• Added support for project configuration files uilconfig.* or uilicious.config.* in JSON (recommended), YAML, and JS format. These files are auto-detected and useful for setting up common logic across tests, for example:
  • The headers config allows you to define a map of global request header values that will be configured at the start of the tests and applies to all outgoing requests.

Bug Fixes

• Fixed unexpected TypeError error masking the actual webdriver error in I.seeAlert, UI.COOKIE.isSet and UI.COOKIE.isEqual command.
• Fixed 2-3 second slowdown in the execution of each command due to unnecessary retries as a result of actual webdriver errors being masked by unexpected TypeError.
• Fixed race condition / edge case where in TEST.run may attempt to run a test file before its contents are fully downloaded and written.

Major

• Node 20 Upgrade: Updated the test engine runtime to Node 20 LTS for improved performance and security.
• Applitools Deprecation: Removed support for the legacy Applitools plugin.

Improvements

• Improved how the I.fill command replaces values in input fields that already contain text. This resolves an edge case on some websites where clearing a field would trigger the original value to be restored, causing the new value to be appended instead of fully replacing the existing value. To ensure the value is always replaced, I.fill will now send Ctrl/Cmd + A when a field contains existing text before entering the new value.
• Improved element targeting by rebalancing attribute weights to prioritize attributes with higher intentionality, resulting in more accurate element matching.

Improvements

• Added support for loading CSV files that include separator metadata (for example, sep=;) at the beginning of the file.
• Added TEST.loadCsv and TEST.loadJson as shortcut aliases for the TEST.loadDataFromCsv and TEST.loadDataFromJson commands.

Bug Fixes

• Fixed an issue where I.click does not detect input type=submit buttons.

Improvements

• Added support for TEST.loadDataFromJson and TEST.loadDataFromCsv to load test data directly from the downloads folder.

Documentation: Loading data from downloaded CSV and JSON files

Bug Fixes

• Fixed an issue where the UI.Downloads.hasFile command fails to detect downloaded files when the file name contained uppercase letters.

Improvements

• Updated I.dontSee to retry when page navigation occurs during command execution. If page navigation exceeds the page load timeout, the command will continue retrying until the configured TEST.commandTimeout is reached instead of failing early with a 504 Gateway Timeout error.

Bug Fixes

• Fixed an issue where test commands are failing on pages with inline PDF viewers in Chromium-based browsers. This happens because the PDF viewer was detected as a new browser tab, causing the test to incorrectly switch context to the PDF viewer instead of the parent page.
• Fixed an issue where a no such alert error could be thrown if the current page closed unexpectedly while a test command was being executed.

Bug Fixes

• Fixed an issue where test crashes on pages that load an inline PDF viewer on Chromium-browsers

Improvements

• Added retries to I.switchTab until the target tab is found or the configured TEST.commandTimeout is reached.
• Increased the timeout for the MetaMask setup flow to 60 seconds.
• Added a fallback mechanism to detect and open the MetaMask extension when MetaMask initialisation on browser start exceeds timeout.

Bug Fixes

• Fixed an issue where screenshots taller than 1080 pixels are not captured properly.
• Fixed an issue where screenshots captured from the MetaMask extension could appear completely black.