CodeceptUI
An interactive, graphical test runner for CodeceptJS.
- 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 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:3001 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 takes requries two ports HTTP and WebSockets.
- 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
Changing WebSocket port requires to rebuild an application:
Default ws:// port is 2999. You can change the port by specifying it to WS_PORT environment variable during building Vue application:
WS_PORT=4444 npm run build
If you change ws:// port, don't forget to set up it by --wsPort option at codecept-ui startup.
npx codecept-ui --app --wsPort=4444
Development
See CONTRIBUTING.md
Start CodeceptUI with debug output
codepress uses the debug package to output debug information. This is useful to troubleshoot problems or just to see what codepress is doing. To turn on debug information do
# verbose: get all debug information
DEBUG=codepress:* npx codecept-ui
# just get debug output of one module
DEBUG=codepress: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!
