@qawolf/recorder v0.3.5

Introduction

🐺QA Wolf is an open-source Node package for recording browser tests. It translates your browser actions into Puppeteer and Jest test code.

Quickstart

Record Your Tests: Generate Jest & Puppeteer test code from your browser interactions. QA Wolf supports multiple windows, third party sites, and changing input values with environment variables.

Set up CI: Set up a GitHub action to run your tests with npx qawolf github. Artifacts for debugging are generated per test.

Debug with Ease: Each test run includes a video, gif, interactive DOM recording, and browser logs as artifacts.

Avoid Flakes: QA Wolf waits for the next element or assertion to avoid loading flakes. It finds elements with multiple attributes, or a test attribute you specify (like "data-qa"), to avoid selector flakes. We battle test QA Wolf against public sites on a schedule to keep improving stability.

Get Started

Documentation

1. Install QA Wolf as a dev dependency

npm i -D qawolf

2. Record your test

npx qawolf record <url> [name]

3. Run your test!

npx qawolf test [name]

Set up CI

Documentation

Set up CI with GitHub Actions:

npx qawolf github

This will generate a file called qawolf.yml in the .github/workflows directory at the root of your project. Edit this file as you like!

Support

We want QA Wolf to work for you, so please reach out to get help!

Gitter

E-mail

Acknowledgements

The DOM Recording artifact is using @Yuyz0112's awesome rrweb library!