puppeteer JavaScript e2e-tests record playback test
Need help with softest?
Click the β€œchat” button below for chat support from the developer who created it, or find similar developers for support.
prprprus

Description

Recording Browser Interactions And Generating Test Scripts.

205 Stars 23 Forks BSD 2-Clause "Simplified" License 150 Commits 5 Opened issues

Services available

Need anything else?

softest

logo

build status Known Vulnerabilities license

The softest is a test tool for recording browser interactions and generating test scripts, simple and practical. It allows you to get test scripts without writing code.

softest2.png

πŸ” Why

When I needed a tool that could record browser interactions and generate corresponding scripts, I found puppeteer-recorder and Selenium IDE, of course, they are excellent projects. But I found that they can't support multi-tab recording, screenshots, etc., and Selenium IDE always gives an error when playing a script, so I made this wheel.

πŸ”₯ Features

Supported Features

  • Single tab recording
  • Multiple tab recording
  • Screenshot
  • Generating test script
  • Playback script
  • Download test report (contains screenshots and test script)

Supported Interactions

  • Click
  • New tab
  • Close tab
  • Change URL
  • Input
  • Scroll page

Tab switching rules: temporarily not support manual tapping tabs to switch pages. For example, opened three tabs, currently in the latest tab3, you can't manually switch to tab2 or tab1 at this time, which will cause inconsistency, but you can go back to tab2 through close tab3, then close tab2 and return to tab1.

βš™οΈ Installation

Dependencies

  • Node >= v10.16.3 (recommend v12.8.0)
  • Npm (recommend 6.10.2)
$ npm i -g softest

The softest is based on Puppeteer, when downloading Puppeteer, Chromium will be downloaded by default. Chinese users may be affected by GFW. If you encounter difficulties, you can move to README-Zh.md.

πŸš€ Usage

Add environment variables to facilitate running commands:

$ export PATH=$PATH:$HOME/.npm-global/bin

softest
has only a few parameters:
$ softest --help
Usage: index [options]

Options: -h, --host Server hostname, optional. (default: "127.0.0.1") -p, --port Server port, optional. (default: 2333) -c, --chromium The absolute path of the chromium execution file, necessary. -r, --report The absolute path of the test report, necessary. -h, --help output usage information

To run the

softest
command, you need to specify the directory where the Chromium and the directory where the test report is saved:
$ soft -c PATH_CHROMIUM -r PATH_REPORT

If you don't know where the Chromium is, you can start Chromium and type

chrome://version/
in the address bar to find the location of its executable.

If you see an output similar to the following, congratulations πŸŽ‰πŸŽ‰πŸŽ‰πŸ‘

 _______  _______  _______  _______  _______  _______  _______
|       ||       ||       ||       ||       ||       ||       |     status: running
|  _____||   _   ||    ___||_     _||    ___||  _____||_     _|     host: 127.0.0.1
| |_____ |  | |  ||   |___   |   |  |   |___ | |_____   |   |       port: 2333
|_____  ||  |_|  ||    ___|  |   |  |    ___||_____  |  |   |
 _____| ||       ||   |      |   |  |   |___  _____| |  |   |
|_______||_______||___|      |___|  |_______||_______|  |___|

πŸŽ‰ Running WebSocket server successfully

πŸŽ‰ Running HTTP server successfully

Open a browser, type

host
and
port
, you will see the following web interface:

softest1.png

⭐️ Show Your Support

Please give a ⭐️ if this project helped you!

πŸ‘ Contributing

If you have any questions or requests or want to contribute to

moveable
or other packages, please write the issue or give me a Pull Request freely.

🐞 Bug Report

If you find a bug, please report to us opening a new Issue on GitHub.

πŸ“ License

See LICENSE for more information.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.