DEV Community

Cover image for Root Cause: Troubleshoot Puppeteer & Playwright Tests with ease
Bnaya Peretz
Bnaya Peretz

Posted on

11 5

Root Cause: Troubleshoot Puppeteer & Playwright Tests with ease

tl;dr
Root Cause is a new open-source Node.js library, to help you visualize and troubleshoot your E2E Puppeteer & Playwright tests.
checkout our demo and integration example on GitHub

The Challenge

End-to-end tests are important, so you want a lot of them. They are also difficult and time-consuming to debug.
For example, if a test failed in headless mode, you will need to re-run it, manually save screenshots, debug step-by-step and go through console logs and network requests to understand what went wrong.
Often tests are successful on one run and fail on the next. Like that noise in your car’s engine when you take it to the mechanic—it doesn’t always reproduce. It makes it very hard to debug these tests, or for the mechanic to figure out if your car has a problem.🕵🏽‍♂️

The missing piece

While Puppeteer and Playwright are excellent browser automation libraries, we still need to do a lot by ourselves to understand what’s happening when tests don’t perform as expected.

The solution: Root Cause Open-Source 🔎

Just a simple integration and without any code change,
Root Cause will automatically detect distinct steps in your tests, capture screenshots, highlight interacted elements, collect console logs, network activity, and stack traces of errors and steps.
All of that is viewable in an intuitive and modern web-based viewer:

Root Cause Viewer
Root Cause viewer screenshot

From Jest test run to Root Cause
Root Cause test run and viewer

How to get started

Go over to our documentation site and checkout our integration examples
Visit (and ⭐️) our GitHub repository https://github.com/testimio/root-cause,
or run the demo
https://github.com/testimio/root-cause-interactive-demo/

Testim 💙 Open Source

Root Cause is an open-source project hosted on GitHub and maintained by Testim. Download, modify, and use in your environment for free.

Root Cause is evolving, your feedback and involvement are highly valuable

We have a lot of experience with end-to-end tests, but we know that to give the best user experience, you need to hear the user's voice.
And since it's open-source, you can help us make it better!

So please try it, and write to us via GitHub issue, GitHub discussion or by email: benji@testim.io, bnaya@testim.io

Hostinger image

Get n8n VPS hosting 3x cheaper than a cloud solution

Get fast, easy, secure n8n VPS hosting from $4.99/mo at Hostinger. Automate any workflow using a pre-installed n8n application and no-code customization.

Start now

Top comments (0)

Qodo Takeover

Introducing Qodo Gen 1.0: Transform Your Workflow with Agentic AI

Rather than just generating snippets, our agents understand your entire project context, can make decisions, use tools, and carry out tasks autonomously.

Read full post

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay