Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/intuit/replayweb
ReplayWeb is a collection of tools to accelerate building and maintaining functional tests for user interfaces.
https://github.com/intuit/replayweb
chrome-extension hacktoberfest javascript replay testing
Last synced: 6 days ago
JSON representation
ReplayWeb is a collection of tools to accelerate building and maintaining functional tests for user interfaces.
- Host: GitHub
- URL: https://github.com/intuit/replayweb
- Owner: intuit
- License: agpl-3.0
- Created: 2019-10-03T16:18:22.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T21:03:37.000Z (11 months ago)
- Last Synced: 2024-05-08T11:23:40.962Z (6 months ago)
- Topics: chrome-extension, hacktoberfest, javascript, replay, testing
- Language: JavaScript
- Homepage:
- Size: 1.65 MB
- Stars: 16
- Watchers: 7
- Forks: 38
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
ReplayWeb
All-in-one toolbox for generating browser automation
[](https://circleci.com/gh/intuit/ReplayWeb)
[](https://github.com/intuit/auto)
[](https://github.com/prettier/prettier)
ReplayWeb is a all-in-one toolbox that allows developers to focus on writing and maintaining application code, not test code. It is comprised of a Chrome extension that you install in your Chrome browser that allows you to record test scripts and saved and played back later. Once you have recorded scripts you can play them back from within the extension or on the command line. The command line execution uses the ReplayWeb Test Runner to automatically convert tests to WebDriverIO scripts that can be played back across different browsers.
### Feature highlights
:rocket: Easy script recording via a Chrome extension
:rocket: Ability to execute recorded tests locally via Chrome extension or command line
:rocket: Integration with source code repositories to enable running tests during CI/CD
## Getting Started with ReplayWeb
### Installing the Chrome Extension
1. Grab the latest release from [the releases](https://github.com/intuit/ReplayWeb/releases); the packaged Chrome extension is a `.crx` file
2. In Chrome navigate to the [extension management page](chrome://extensions) (`chrome://extensions`)
3. Drag and drop the `.crx` file over the page to install
4. In a terminal, run one of the following commands based on how you authenticate with github:
- Personal Access Token: `curl -L https://raw.githubusercontent.com/intuit/replayweb/master/packages/host/src/static/setup.sh | bash`
- SSH Keys: `curl -L https://raw.githubusercontent.com/intuit/replayweb/master/packages/host/src/static/setup-ssh.sh | bash`
For additional details see the [readme](packages/extension/README.md) for the Chrome Extension.
### Installing the Test Runner
Available through npm, `@replayweb/testrunner` converts your JSON tests recorded from the Chrome extension into webdriverio tests. To get started, install the required dependencies into your project:
*If you're using npm 5+*
```sh
npx install-peerdeps --dev @replayweb/testrunner
```
If using `yarn`, you can also use the shortcut described above if you have npm 5+ installed on your machine, as the command will detect that you are using yarn and will act accordingly.
*If you're using npm <5 intall the deps listed from the following command*
```sh
npm info "eslint-config-airbnb@latest" peerDependencies
```
And add a simple `wdio.conf.js`:
```js
const { getDefaults, loadFromConfig } = require('@replayweb/testrunner');
exports.config = { ...getDefaults(), ...loadFromConfig() };
```
This will read the `replay.config.json` from your repository, that was created by the Chrome extension and load all of your tests and suites. To execute the tests in your shell you can do `npx wdio`, or add a script to `package.json` that just executes `wdio`.
For additional details see the [readme](packages/testrunner/README.md) for the Test Runner package.
## Documentation
The documentation is divided into several sections:
- [Chrome Extension](packages/extension/README.md)
- [Test Runner](packages/testrunner/README.md)
- See full list of documentation [here](packages/)
## Contributing
Read below to learn how you can take part in improving ReplayWeb.
### Code of Conduct
Intuit has adopted a Code of Conduct that we expect project participants to adhere to. Please read the [full text](.github/CODE_OF_CONDUCT.md) so that you can understand what actions will and will not be tolerated.
### Contributing Guide
Thanks for your interest! Please see the [CONTRIBUTING.md](.github/CONTRIBUTING.md) file for more information on how to develop and test your changes before contributing bug fixes and enhancements for ReplayWeb.
### Good First Issues
To help you get your feet wet with our contribution process, we have a list of [good first issues](https://github.com/intuit/replayweb/labels/good%20first%20issue) that have a relatively limited scope. This is a great place to get started.
## License
This project is licensed under [AGPL 3](LICENSE).