https://github.com/mixpanel/domsuite
JavaScript browser testing/automation utilities with async/await
https://github.com/mixpanel/domsuite
keep mxpnl-analytics
Last synced: about 1 year ago
JSON representation
JavaScript browser testing/automation utilities with async/await
- Host: GitHub
- URL: https://github.com/mixpanel/domsuite
- Owner: mixpanel
- Created: 2018-08-08T20:20:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-07-19T17:13:40.000Z (almost 3 years ago)
- Last Synced: 2025-03-24T13:51:15.306Z (about 1 year ago)
- Topics: keep, mxpnl-analytics
- Language: JavaScript
- Homepage:
- Size: 2.04 MB
- Stars: 3
- Watchers: 46
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# domsuite
*Work In Progress*
JavaScript browser testing/automation utilities. Uses `async/await` syntax to make
asynchronous UI interactions straightforward.
Mocha example:
```js
import {clickElement, condition, nextAnimationFrame} from 'domsuite';
describe(`my sweet UI`, function() {
it(`renders the foo when I click the bar`, function() {
await clickElement(document.querySelector(`.bar`));
await nextAnimationFrame();
expect(document.querySelector(`.bar`)).to.be.null;
await condition(() => !!document.querySelector(`.foo`));
});
});
```
## Installation
`npm install --save-dev domsuite`
## Development / Running tests
#### Install dependencies
`npm install`
Browser tests run with Selenium through [web-component-tester](https://github.com/Polymer/tools/tree/master/packages/web-component-tester).
#### Run with locally installed browsers
`npm test`
#### Tunnel to [Sauce Labs](https://saucelabs.com/)
`SAUCE=1 npm test`
Set credentials with environment variables `SAUCE_USERNAME` and `SAUCE_ACCESS_KEY`. The default browser/OS matrix is defined in `wct.conf.js`.
#### Testing dev loop
- Terminal 1: Build browser test bundles, rebuild when source files change: `WATCH=true npm run test-build`
- Terminal 2: Launch browsers, keep alive after tests run: `PERSISTENT=true npm run test-run`
- Change source files, refresh browser tab to rerun tests
- Open browser dev tools to stop on breakpoints, debug, etc
## License
MIT