Love numbers? You'll love Serenity/JS 3.29! 🎉

We’re excited to share the latest release of Serenity/JS, which is packed with new powerful features for handling numeric data in your automated tests!

New to Serenity/JS?​

Serenity/JS web testing tutorial was called "the best guide if you want to take your automation skills to the next level." ❤️

If you're new to Serenity/JS or web automation in general, start with "Your first web scenario".

New in Serenity/JS 3.29​

Built-in support for arithmetic operations​

Part of the Serenity/JS Core module, the new Numeric class offers built-in support for performing arithmetic operations on both synchronous and asynchronous data types directly within your Serenity/JS test scenarios.

In addition, this new class offers methods to help you extract numeric data from REST API responses and web interfaces and convert it to a desired numeric data type without any external libraries or complex workarounds.

This enhancement makes your tests more readable, reduces the risk of calculation errors, and ensures data-driven scenarios are both easy to implement and maintain. With Numeric, your test logic is cleaner, making Serenity/JS even more developer-friendly.

Learn about Numeric.

More Serenity/JS examples in your IDE!​

We continue our effort to bring the thousands of examples available in the Serenity/JS API documentation close to you and your team. As part of that, the new Numeric class ships with 15 new examples, demonstrating how to extract numeric data from user interfaces and data objects. You'll also learn how to use the new features with Serenity/JS Page Element Query Language to make extracting the right UI element even easier!

Check out the Serenity/JS API docs at https://serenity-js.org/api/

Enjoy Serenity!

Your feedback matters!​

I hope this latest release of Serenity/JS will make it even easier for you and your team to create high-quality test automation.

Let me know what you think of the new features in the comments below 👇👇👇

📣 Stay up to date​

New features, tutorials, and demos are coming soon! Follow Serenity/JS on LinkedIn, subscribe to Serenity/JS channel on YouTube and join the Serenity/JS Community Chat to stay up to date! Please also make sure to star ⭐️ Serenity/JS on GitHub to help others discover the framework!

💛 Support Serenity/JS​

If you appreciate all the effort that goes into making sophisticated tools easy to work with, please support our work and become a Serenity/JS GitHub Sponsor today!

In the ever-evolving world of software development, the importance of clear, concise, and accessible documentation cannot be overstated. The Serenity/JS team is thrilled to announce a series of significant improvements to our API documentation, designed to enhance the developer experience and streamline the process of building automated acceptance tests. These updates are crafted to support developers at every stage of their journey, from understanding the basics to mastering the intricacies of the framework.

A new gateway to learning​

The newly revamped API Docs landing page serves as the central hub for all things Serenity/JS, providing a comprehensive overview that we believe is both welcoming to newcomers and invaluable to seasoned developers. The landing page is now your go-to resource for navigating the extensive Serenity/JS ecosystem. Whether you’re looking for detailed class references, method signatures, or specific modules, the structured layout ensures that everything you need is just a click away.

Compatibility at a glance​

One of the standout additions to our documentation is the Serenity/JS compatibility matrix, a tool we believe will help developers stay up to date with their project's dependencies.

This page is especially useful because:

• Version Matching: It allows you to quickly determine which versions of Serenity/JS are compatible with your project’s existing setup, helping to prevent integration issues before they arise.
• Upgrade Guidance: The matrix offers insights into the latest compatible versions, making it easier for developers to plan upgrades without disrupting their workflow.
• Cross-Referencing: Links to detailed release notes and API changes offer immediate access to further information, enabling you to make informed decisions about when and how to update your dependencies.

API documentation in your IDE​

Another exciting improvement is the availability of diagrams, examples, and direct links to the API documentation directly within your IDE. These enhancements ensure that you have all the necessary resources at your fingertips, right when you need them. With context-specific information available inline, you no longer need to interrupt your workflow to search for documentation elsewhere.

• Contextual Diagrams: Visual representations of class hierarchies and relationships help you understand how different parts of the framework interact, improving comprehension and reducing errors.
• Embedded Examples: Code snippets within the IDE provide immediate examples of how to implement specific features, speeding up development and reinforcing learning.
• Instant Documentation Links: With direct links to the Serenity/JS API docs embedded in your code editor, you can quickly reference detailed documentation without breaking your focus.

These improvements are designed to keep developers in their flow, reducing the time spent searching for information and increasing productivity.

Your feedback matters!​

I hope this latest release of Serenity/JS will make it even easier for you and your team to create high-quality test automation.

Let me know what you think of the new features in the comments below 👇👇👇

📣 Stay up to date​

New features, tutorials, and demos are coming soon! Follow Serenity/JS on LinkedIn, subscribe to Serenity/JS channel on YouTube and join the Serenity/JS Community Chat to stay up to date! Please also make sure to star ⭐️ Serenity/JS on GitHub to help others discover the framework!

💛 Support Serenity/JS​

If you appreciate all the effort that goes into making sophisticated tools easy to work with, please support our work and become a Serenity/JS GitHub Sponsor today!

📣 Serenity/JS Tasks, Interactions and Questions now support dynamic descriptions 🎉

With the new release of Serenity/JS 3.24, descriptions of Tasks, Interactions, and Questions, including assertions and synchronisation statements, can be determined dynamically at runtime and incorporate the actual values of static and dynamic parameters you passed in.

The new dynamic descriptions feature is particularly useful when designing custom Serenity/JS tasks that accept notes or other dynamic data structures like questions, question adapters, or answerables.

Long story short: to use dynamic descriptions, upgrade to Serenity/JS 3.24 and replace d with the in your custom Task and Interaction definitions:

- import { Task, d } from '@serenity-js/core';
+ import { Task, the } from '@serenity-js/core';

export const recordItem = (name: Answerable<string>): Task =>
- Task.where(d`#actor records an item called ${ name }`,
+ Task.where(the`#actor records an item called ${ name }`,
    Enter.theValue(name).into(newTodoInput()),
    Press.the(Key.Enter).in(newTodoInput()),
    Wait.until(itemNames(), contain(name)),
  )

This tiny change to your code will enable your Serenity reports to show the actual values of your task and interaction parameters.

Want to learn more? Read on!

📣 Serenity/JS now supports tagging across all the test runners 🎉

With the new release of Serenity/JS 3.21, tagging test scenarios just got easier. Now, you can use @tags across all the supported test runners, so:

• Cucumber
• Jasmine
• Mocha
• WebdriverIO
• Playwright Test
• Protractor

Why should you tag your scenarios?​

Tagging test scenarios helps you organise and filter your test suites. You can categorise tests based on functionality, priority, or type, making it easier to manage and focus your testing efforts.

Plus, tagging allows for selective test execution. You can run a subset of tests by specifying relevant tags, which is handy for regression testing or when focusing on specific parts of your application.

Tagging also improves test reporting and integrates well with test management tools. It gives you insights into test coverage and helps streamline test planning and tracking.

And if you're using Playwright Test, Serenity/JS supports the latest Playwright 1.42 tag API, enhancing your tagging capabilities even further!

Contributor spotlight​

A huge thank you to our Serenity/JS Contributors for their work on this release:

• Otoniel Isidoro, who enabled tagging support for Playwright Test
• Mateusz Kruk, who greatly improved Playwright Test global error handling

Enjoy Serenity!

Serenity/JS 3.15.0 introduces support for Serenity BDD 4 and aggregated test reports for Playwright Test, WebdriverIO, Mocha, Jasmine and Cucumber! 🥳

We've also updated the Serenity/JS Handbook to help you get the most out of the new Serenity/JS and Serenity BDD reporting features - check out:

• Reporting > Serenity BDD Reporter
• Serenity BDD Best Practices (NEW!)

Important changes​

If you're still using the Serenity/JS 2-style syntax for registering the SerenityBDDReporter, you'll need to update your configuration file to use the Serenity/JS 3 convention:

- import { ArtifactArchiver } from '@serenity-js/core';
- import { SerenityBDDReporter } from '@serenity-js/serenity-bdd';

// ...
    crew: [
-     new SerenityBDDReporter(),
-     ArtifactArchiver.storingArtifactsAt('./target/site/serenity'),
+     '@serenity-js/serenity-bdd',
+     [ '@serenity-js/core:ArtifactArchiver', {
+       outputDirectory: 'target/site/serenity'
+     } ],
    ]
// ...

Learn more about Configuring Serenity BDD Reporter.

Serenity/JS 3.3.0 introduces support for Playwright Test UI Mode, improves support for Playwright trace viewer, and leverages Playwright auto-waiting locators! 🥳

Check out our new tutorial where in less than 5 minutes, you'll learn how to integrate Serenity/JS with your Playwright test suite, enable Serenity BDD reports, start using the Screenplay Pattern, and get started with Playwright Test UI Mode!

Learn about Using Serenity/JS with Playwright Test!

Serenity/JS started to support WebdriverIO in version 2.30.0.

In version 3.0.0, Serenity/JS brought you @serenity-js/web - a portable abstraction layer that lets you run the exact same web scenario with WebdriverIO, Playwright, and even Protractor!

Now, we're taking things further with Serenity/JS 3.2.0 introducing support for the latest and greatest WebdriverIO 8! 🥳

Check out our new tutorial where in less than 5 minutes, you'll learn how to integrate Serenity/JS with your WebdriverIO test suite, enable Serenity BDD reports, and start using the Screenplay Pattern!

Learn about Using Serenity/JS with WebdriverIO!

When Titus Fortner (@titusfortner), the maintainer of Watir and a contributor to Selenium, messaged me on Twitter two months ago, I knew something interesting was coming.

Titus and I never met in person. In fact, I have never met most of the other open-source maintainers I've worked with over the last ten years since I became an open-source maintainer myself and the last six years I spent working on Serenity/JS.

This is not that surprising, to be fair. After all, have you ever met any of the people maintaining the open-source libraries and frameworks that your work depends on?

Well, in my case, this was about to change.