Playwright Test

Playwright Test is a test runner specifically designed to accommodate the needs of browser-based end-to-end and component test automation using the Playwright web automation library. Playwright supports all modern rendering engines, including Chromium, WebKit, and Firefox. It also enables test execution on Windows, Linux, and macOS, whether locally or in CI environments, in both headless and headed modes, with native mobile emulation for Google Chrome on Android and Mobile Safari.

Serenity/JS revolutionises automated testing by enabling teams to write expressive, maintainable tests that align with their unique domain. Seamlessly integrating with Playwright and Playwright Test, Serenity/JS also offers advanced reporting that provides clear insights into test results, aiding both technical teams and business stakeholders in assessing system quality.

Benefits of integrating Playwright Test with Serenity/JS:

• Enhanced Reporting – Use Serenity/JS to augment Playwright Test reports and generate living documentation with Serenity BDD.
• Reusable Code – Leverage the Screenplay Pattern to write maintainable test code, facilitate collaboration, and implement multi-actor, multi-interface test scenarios.
• Integration Libraries – Interact seamlessly with REST APIs, local Node.js servers, and verify complex workflows with ready-to-use integration libraries.

Native Playwright Test HTML report, Playwright UI View, and Playwright Trace Viewer augmented with information from Serenity/JS Screenplay Pattern APIs and screenshots automatically captured by the Serenity/JS Photographer

Quick start 🚀

To start testing immediately, consider using:

• Serenity/JS Project Templates for Playwright Test - Pre-configured with essential dependencies.
• Serenity/JS GitHub Codespaces - Ready-to-use cloud-based development environments.
• Serenity/JS reference implementations on GitHub.

New to Serenity/JS? ⏱️ Check out the tutorials!

See what Serenity/JS is capable of without installing anything on your machine - start with our 15-minute web testing tutorial!

To see Serenity/JS reporting in action, explore the live reports generated by the Serenity/JS Playwright Test Template:

• Live Serenity BDD report
• Live Playwright Test report

Learning path

We recommend following these pages in order to get the most out of the integration:

1. Installation – Set up Playwright Test and add Serenity/JS integration modules.
2. Configuration – Configure test reports and automatic screenshots.
3. Writing tests – Write test scenarios using Serenity/JS Screenplay Pattern APIs.
4. Multi-actor scenarios – Implement scenarios with multiple actors and independent browsers.
5. Customising actors – Modify abilities, share notes, and replace the default cast.
6. Testing Electron apps – Test desktop Electron applications with Serenity/JS.
7. Reporting – Generate rich reports with Playwright and Serenity BDD.
8. Integration architecture – Understand how Serenity/JS integrates with Playwright Test.