100 lines
2.1 KiB
Markdown
100 lines
2.1 KiB
Markdown
## Build the Docker image
|
|
|
|
docker build -t btroops .
|
|
|
|
## Install packages
|
|
|
|
./npm install
|
|
|
|
## Start the dev server
|
|
|
|
./npm run start
|
|
|
|
Visit `localhost:8080` to view.
|
|
|
|
## Run integration tests
|
|
|
|
./npm run test:integ
|
|
|
|
### Debugging an integration test
|
|
|
|
1. Put `debugger` in whatever test you want to debug.
|
|
|
|
2. Add `only` to the test's `it` function call.
|
|
|
|
From `it(...` to `it.only(...`.
|
|
|
|
3. Then run `./npm run test:integ:debug` to start start the debugger.
|
|
|
|
```
|
|
> test:integ:debug
|
|
> NODE_INSPECT_RESUME_ON_START=1 node inspect ./node_modules/jest/bin/jest.js --config jest.config.integ.cjs --runInBand test/integration/page.test.js
|
|
|
|
< Debugger listening on ws://127.0.0.1:9229/7150f5fc-339a-4171-af42-b8902d0d3e31
|
|
< For help, see: https://nodejs.org/en/docs/inspector
|
|
<
|
|
connecting to 127.0.0.1:9229 ... ok
|
|
< Debugger attached.
|
|
<
|
|
< Jest config file read.
|
|
<
|
|
<
|
|
< Spawning server process...
|
|
<
|
|
< Test server running at http://localhost:3005
|
|
< Build completed in 11ms
|
|
<
|
|
<
|
|
break in test/integration/page.test.js:31
|
|
29 counter = await driver.findElement(By.css(selector), svg);
|
|
30 await counter.click();
|
|
>31 debugger;
|
|
32 expect(await counter.getAttribute('class')).toEqual(expect.stringContaining('selected'));
|
|
33 });
|
|
debug>
|
|
```
|
|
|
|
4. To run the test again without having to quit the debugger, use `c` to continue past the breakpoint and then `r` to restart.
|
|
|
|
```
|
|
debug> c
|
|
...
|
|
<
|
|
< Stopping server.
|
|
<
|
|
< Waiting for the debugger to disconnect...
|
|
<
|
|
```
|
|
|
|
```
|
|
debug> r
|
|
< Debugger listening on ws://127.0.0.1:9229/1cda953e-c9ae-41d8-9d4a-e41a567e0826
|
|
< For help, see: https://nodejs.org/en/docs/inspector
|
|
<
|
|
connecting to 127.0.0.1:9229 ... ok
|
|
< Debugger attached.
|
|
<
|
|
< Jest config file read.
|
|
<
|
|
<
|
|
< Spawning server process...
|
|
<
|
|
< Test server running at http://localhost:3005
|
|
< Build completed in 11ms
|
|
<
|
|
<
|
|
break in test/integration/page.test.js:31
|
|
29 counter = await driver.findElement(By.css(selector), svg);
|
|
30 await counter.click();
|
|
>31 debugger;
|
|
32 expect(await counter.getAttribute('class')).toEqual(expect.stringContaining('selected'));
|
|
33 });
|
|
debug>
|
|
```
|
|
|
|
### References
|
|
|
|
https://nodejs.org/en/learn/getting-started/debugging
|
|
|
|
https://nodejs.org/api/debugger.html
|