TL;DR

TestCafe now handles URLs more reliably, resolving errors when preparing base URLs for tests.

Fixes Worth Knowing

• Fixed a TypeError when processing URLs.
• Removed an unused dependency (js-yaml), reducing package size.
• Updated internal dependencies for improved stability.

TL;DR

TestCafe now handles file uploads and downloads more reliably in CI/CD workflows (continuous integration/continuous delivery) and remote mobile testing.

Fixes Worth Knowing

File upload and download actions in CI/CD pipelines are now more stable, preventing issues with artifact naming and unnecessary uploads during remote mobile tests. Window resizing now correctly triggers maximize functionality.

TL;DR

TestCafe no longer includes Experimental Debug mode, encouraging users to adopt the more robust Visual Selector Debugger (browser-based debugging tool) for troubleshooting selectors.

Breaking

• Experimental Debug mode removed: This feature is no longer available; use the Visual Selector Debugger instead.

Fixes Worth Knowing

• Fixed issues with TestCafe hanging in Internet Explorer 11.
• Resolved problems with pressKey('space') not working correctly on checkboxes in Firefox.
• Corrected errors related to Request Hooks (intercepting network requests) and URL processing when running in Native Automation mode.
• Fixed browser alias reporting for Microsoft Edge.
• Resolved crashes when launching multiple tests simultaneously via the Test Runner API.

TL;DR

TestCafe now more reliably handles keyboard input, redirects on sites like YouTube, and requests within native automation (browser control via code).

Fixes Worth Knowing

• Spacebar now correctly toggles checkbox states.
• TestCafe Studio’s recorder now functions correctly when request hooks are added.
• Native automation no longer hangs on sites with URL hashes.
• Modifier keys (like Shift/Ctrl) now work with hover actions in native automation.

Before You Upgrade

Remove any uses of the --experimental-debug flag, as this feature has been removed.

TL;DR

TestCafe now supports running tests on about:blank pages (empty webpages) and improves resource injection when using proxyless mode (running tests without a proxy server).

Fixes Worth Knowing

Subtitles are now correctly displayed during test finalization.

Before You Upgrade

If you were using TestCafe with about:blank pages, verify functionality after upgrading.

TL;DR

TestCafe now handles shadow DOM iframes and avoids memory leaks when running many tests concurrently, improving stability for complex applications.

Fixes Worth Knowing

• Fixed a memory leak when running 11+ tests in parallel.
• TestCafe can now switch to iframes within shadow DOM elements (nested HTML structures).
• Corrected handling of network request hooks (intercepting/modifying requests) returning 500 status codes.
• Prevents execution of invalid JSON files as tests.

TL;DR

TestCafe now provides more informative error messages and improved stability, particularly when running tests in Docker or with remote browsers.

Fixes Worth Knowing

• Tests now fail clearly when no fixture is defined.
• Remote browsers start after test compilation, resolving potential timing issues.
• TestCafe handles long waits and browser screenshot support more gracefully, preventing unexpected failures.
• Improved XHR request handling and iframe compatibility fix issues in specific browsers (IE11, Firefox).
• Docker images now include version tags (for easier identification).

TL;DR

TestCafe now supports native asynchronous (JavaScript promises) assertions, improving readability and simplifying complex test logic.

New

• Native asynchronous assertion support allows using await and async directly within TestCafe tests for cleaner, more maintainable code.
• Improved handling of beforeEach and afterEach hooks to reliably execute even when tests are skipped.