113 lines
2.5 KiB
Markdown
113 lines
2.5 KiB
Markdown
## Live
|
|
|
|
<a href="https://apps.miti.sh/btroops" target="_blank">Demo</a>
|
|
|
|
## Run
|
|
|
|
1. Build the Docker image
|
|
|
|
docker build -t btroops .
|
|
|
|
2. Install `node` packages
|
|
|
|
./npm install
|
|
|
|
3. Start development server
|
|
|
|
./npm run start
|
|
|
|
4. Visit `localhost:8080` with browser to view app.
|
|
|
|
## Command to install `pan-zoom` package from repo
|
|
|
|
```console
|
|
$ ./npm install --save https://git.miti.sh/ccm/pan-zoom/archive/v0.3.0.tar.gz
|
|
```
|
|
|
|
## Integration tests
|
|
|
|
### Run
|
|
|
|
./npm run test:integ
|
|
|
|
### Debug
|
|
|
|
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/en/learn/getting-started/debugging)
|
|
- [https://nodejs.org/api/debugger.html](https://nodejs.org/api/debugger.html)
|