blob: 873560d3ae1336415448404777b84a8bacce51be (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
## Live
<a href="http://apps.webdevcat.me/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.
## 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)
|