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