TL;DR

TestCafe’s npm installation process is more reliable, resolving issues some users experienced when installing the package.

Fixes Worth Knowing

The npm install command should now complete without errors for more users.

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.