https://github.com/codeceptjs/ui
Web UI for CodeceptJS
https://github.com/codeceptjs/ui
codeceptjs testing visual
Last synced: 13 days ago
JSON representation
Web UI for CodeceptJS
- Host: GitHub
- URL: https://github.com/codeceptjs/ui
- Owner: codeceptjs
- License: mit
- Created: 2019-10-19T13:26:07.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-05-15T00:04:46.000Z (14 days ago)
- Last Synced: 2025-05-15T05:27:18.234Z (14 days ago)
- Topics: codeceptjs, testing, visual
- Language: JavaScript
- Homepage: https://codecept.io
- Size: 9.18 MB
- Stars: 83
- Watchers: 10
- Forks: 28
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# CodeceptUI
An interactive, graphical test runner for [CodeceptJS](https://codecept.io).
* Runs as Electron app or as a web server
* Headless & window mode supported
* Test write mode
* Interactive pause built-in
* Snapshots & Time travel
* Runs tests in CodeceptJS supported engines:
* Playwright
* Puppeteer
* webdriverio
* TestCafe
## Quickstart
**Requires [CodeceptJS 3](https://codecept.io) to be installed**
Install CodeceptUI in a project where CodeceptJS is already used
```
npm i @codeceptjs/ui --save
```
### Application Mode
Run CodeceptUI in application mode (recommended for development, local debug):
```
npx codecept-ui --app
```
Uses `codecept.conf.js` config from the current directory.
If needed, provide a path to config file with `--config` option:
```
npx codecept run --config tests/codecept.conf.js
```
### WebServer Mode
Run CodeceptUI as a web server (recommended for headless mode, remote debug):
```
npx codecept-ui
```
Open `http://localhost:3333` to see all tests and run them.
Uses `codecept.conf.js` config from the current directory.
If needed, provide a path to config file with `--config` option:
```
npx codecept run --config tests/codecept.conf.js
```
#### Ports
CodeceptUI requires two ports HTTP and WebSocket.
* HTTP Port = 3333
* WebSocket Port = 2999
Default HTTP port is 3333. You can change the port by specifying it to **--port** option:
```
npx codecept-ui --app --port=3000
```
Default WebSocket port is 2999. You can change the port by specifying it to **--wsPort** option:
```
npx codecept-ui --app --wsPort=4444
```
## Development
See [CONTRIBUTING.md](.github/CONTRIBUTING.md)
## Start CodeceptUI with debug output
CodeceptUI uses the [debug](https://github.com/debug-js/debug) package to output debug information. This is useful to troubleshoot problems or just to see what CodeceptUI is doing. To turn on debug information do
```
# verbose: get all debug information
DEBUG=codeceptjs:* npx codecept-ui
# just get debug output of one module
DEBUG=codeceptjs:codeceptjs-factory npx codecept-ui
```
# Credits
- Originally created by Stefan Huber @hubidu27
- Maintained my @davertmik
- Icons/Logos Code Icon by Elegant Themes on Iconscout
# Contributors
Thanks all for the contributions!
[//]: contributor-faces
[//]: contributor-faces