Current releases and compatibility
Node.js compatibility​
To help ensure optimal stability of your test scenarios, you should use a recent Long-Term Support (LTS) version of the Node.js platform.
Serenity/JS is tested with the latest versions of Node.js 18.12, 20, and 22. While non-LTS versions of Node.js may work, they are not officially supported and you should avoid using them in production environments.
Serenity/JS compatibility​
Serenity/JS helps you integrate your test automation framework with your favourite tools and libraries.
To make sure your Serenity/JS setup is up to date and you're using the right versions of the Serenity/JS modules, check the compatibility matrix below.
| Serenity/JS Modules | Compatibility | ||
|---|---|---|---|
| Package | Current version | Package | Compatible versions |
| Core Modules | |||
| @serenity-js/core | 3.31.1 | ||
| @serenity-js/assertions | 3.31.1 | ||
| Web Testing | |||
| @serenity-js/web | 3.31.1 | ||
| @serenity-js/playwright | 3.31.1 | playwright-core (required) | ~1.49.0 |
| @serenity-js/protractor | 3.31.1 | protractor (required) | ^5.0.0^7.0.0 |
| @serenity-js/webdriverio | 3.31.1 | @wdio/cli (required) | ^9.4.2 |
| webdriverio (required) | ^9.4.2 | ||
| @serenity-js/webdriverio-8 | 3.31.1 | @wdio/cli (required) | ^8.40.6 |
| webdriverio (required) | ^8.40.6 | ||
| REST API Testing | |||
| @serenity-js/rest | 3.31.1 | axios (direct) | 1.7.9 |
| @serenity-js/local-server | 3.31.1 | @hapi/hapi (optional) | ^21.3.12 |
| express (optional) | ^4.21.2 | ||
| koa (optional) | ^2.15.3 | ||
| restify (optional) | ^11.1.0 | ||
| Reporting | |||
| @serenity-js/console-reporter | 3.31.1 | ||
| @serenity-js/serenity-bdd | 3.31.1 | axios (direct) | 1.7.9 |
| Test Runners | |||
| @serenity-js/cucumber | 3.31.1 | @cucumber/cucumber (optional) | ^7.3.2^8.5.0^9.1.0^10.0.0^11.0.0 |
| cucumber (optional) | ^1.3.3^2.3.1^3.2.1^4.2.1^5.0.0^6.0.0 | ||
| @serenity-js/jasmine | 3.31.1 | jasmine (required) | ^5.5.0 |
| @serenity-js/mocha | 3.31.1 | mocha (required) | ^10.8.2^11.0.1 |
| @serenity-js/playwright-test | 3.31.1 | @playwright/test (required) | ~1.49.0 |
Updating Serenity/JS​
To learn how to keep your Serenity/JS project up-to-date, check out the Updating Serenity/JS guide.