testcafe - npm Package Versions

v1.18.0 (2021-12-22)

TestCafe v1.18.0 includes a new experimental Selector debugging capability, important improvements for macOS users and a number of routine bug fixes.

If you run TestCafe on macOS, follow the Upgrade Guide to make sure your upgrade goes smoothly.

New Debugging Capabilities (Experimental)

If you launch TestCafe with the --experimental-debug flag, you can debug Selectors and Client Functions in the Watch panel of a Node.js debugger.

macOS improvements

TestCafe Browser Tools on Apple Silicon

The TestCafe Browser Tools package is a communication layer that automates browsers on behalf of TestCafe. Both the TestCafe framework and TestCafe Studio include the TestCafe Browser Tools binary.

Earlier versions of TestCafe Browser Tools were optimized for the x86-64 architecture. Apple Silicon Macs ran those binaries through the Rosetta 2 translation layer. Rosetta 2 took up additional space and prevented TestCafe from taking full advantage of the processor.

TestCafe v1.18.0 includes a Universal TestCafe Browser Tools binary that runs natively on both x64 Macs and Apple Silicon Macs.

Follow the Upgrade Instructions to make sure your version of TestCafe Browser Tools is up to date.

TestCafe Browser Tools macOS Permission Fix

The TestCafe Browser Tools binary requires special privileges to automate browsers and take screenshots. Security improvements in recent versions of macOS made these privileges harder to obtain.

Prior to TestCafe v1.18.0, each installation of TestCafe and TestCafe Studio included a TestCafe Browser Tools binary. macOS users with multiple sets of TestCafe Browser Tools had to go through a lengthy process to obtain the necessary permissions.

TestCafe v1.18.0 and TestCafe Studio v1.7 address this issue. Beginning with this version, all TestCafe installations share a single TestCafe Browser Tools binary. TestCafe stores this binary in the user's Home directory, inside the hidden ~/.testcafe-browser-tools folder.

Follow the Upgrade Instructions to reset TestCafe Browser Tools' permissions and enable the new binary.

Bug Fixes

• TestCafe immediately closes new windows (#6680)
• Tests fail with the TypeError: Invalid value used as weak map key. error (#6563)
• The latest version of the TestCafe Docker image cannot connect to Chrome and Chromium (#6436)
• TestCafe loses test error call stack and outputs the following message instead: "Uncaught object "[object Object]" (Issue #6624. Discovered by @danieltroger, PR by @rob4629.)
• Lack of definitions for two new timeout options results in TypeScript compilation errors (#6713)
• TypeScript filter functions erroneously require a Promise return value (#6705)

v1.17.1 (2021-11-11)

Bug Fixes

• TestCafe incorrectly reads the 'reporter' configuration file option (#6665, #6594).
• An error report displays multiple warnings when you debug a test in headless mode (#6605).
• The testcafe-hammerhead proxy fails to load a web page (testcafe-hammerhead/#2708).