Puppetry is an open-source desktop application that gives non-developers the ability to create, manage, and integrate automated tests for Web
- Can be used by QA engineers with no programming background
- Features Headless Chrome (Puppeteer) and Jest
- Generated tests can be run within the application as well as exported e.g. for CI-server
E2E testing for the Web in a nutshell is about locating a target, applying a browser method on it,
asserting the new page (DOM) state. Where target can be either a HTML element
or the entire page. Page methods can be such as "goto to a URL", "make a screenshot".
For an element - click, focus, type a text and so on. As for assertions we can check for example that element's property
or attribute has a specified value, or element's position and size match the provided criteria.
Puppetry offers you an easy-to-use UI where you choose browser methods and assertions from a predefined list, with predefined settings, guided by extensive tips. Namely you can do the following:
- to declare element targets as pairs
variable = locator, where locator can be either CSS selector or Xpath. When using Chrome DevTool you just right-click on a target element and copy selector or XPath - to manage your test structure in BDD style ( project, suite, test group, test )
- to manage browser methods and assertions
You can download latest installers for your platform from the releases page
Current only the following OS are supported:
- Windows 7 and greater (64 bit)
- Ubuntu 14.04 and greater (64 bit)
- MacOS X 10.10 (Yosemite) and greater (64 bit)
- get acquainted with guides
- the great document about first contributions
- Dev-Notes, e.g. on how to add a browser method/assertion
- examine the Backlog, suggest new features
- look into existing Issues, come up with a fix (
masterbranch) - implement new features (
devbranch)
Please adhere the coding style. We have one based on jQuery's JavaScript Style Guide. You can find the validation rules in .eslintrc
and lint the code by running npm run lint
MIT