webship-js 2.0.10 → 2.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/.circleci/config.yml +10 -1
  2. package/.drone.yml +7 -7
  3. package/.github/ISSUE_TEMPLATE/issue.md +37 -0
  4. package/.github/PULL_REQUEST_TEMPLATE.md +24 -0
  5. package/.github/workflows/github-actions.yml +101 -4
  6. package/.gitlab-ci.yml +9 -4
  7. package/.harness/webship-js-pipeline.yml +5 -6
  8. package/.semaphore/semaphore.yml +6 -9
  9. package/.teamcity/settings.kts +7 -6
  10. package/.travis.yml +6 -1
  11. package/AGENTS.md +1 -1
  12. package/CLAUDE.md +69 -24
  13. package/Jenkinsfile +5 -3
  14. package/README.md +13 -1
  15. package/azure-pipelines.yml +17 -8
  16. package/bamboo-specs/bamboo.yml +9 -15
  17. package/bin/generate-reports.js +51 -7
  18. package/bin/init-webship.js +127 -23
  19. package/bitbucket-pipelines.yml +5 -1
  20. package/buildspec.yml +6 -7
  21. package/cloudbuild.yaml +28 -12
  22. package/codefresh.yml +6 -6
  23. package/cucumber.js +46 -11
  24. package/docs/00-quick-start.md +38 -7
  25. package/docs/02-bbr-smart-waits.md +21 -10
  26. package/docs/03-selector-registry.md +24 -0
  27. package/docs/04-step-reference.md +53 -27
  28. package/docs/05-web-first-assertions.md +6 -0
  29. package/docs/07-auth-state.md +1 -1
  30. package/docs/08-clock-mocking.md +21 -2
  31. package/docs/09-api-testing.md +40 -2
  32. package/docs/10-accessibility.md +2 -0
  33. package/docs/11-debugging.md +24 -1
  34. package/docs/12-ai-agent-guide.md +8 -1
  35. package/docs/13-faq.md +75 -1
  36. package/docs/14-recipes-cookbook.md +2 -0
  37. package/docs/15-tag-conventions.md +5 -1
  38. package/docs/16-ci-cd.md +161 -124
  39. package/docs/README.md +5 -5
  40. package/docs/advanced-screenshots.md +3 -1
  41. package/docs/api-step-definitions.md +16 -2
  42. package/docs/global-settings.md +70 -18
  43. package/docs/install-webship-js/ddev-webship-js.md +3 -0
  44. package/docs/install-webship-js.md +16 -2
  45. package/docs/step-definitions/then-i-should-see.md +14 -1
  46. package/docs/step-definitions/then-item-checkbox.md +2 -0
  47. package/docs/step-definitions/when-i-fill.md +4 -0
  48. package/docs/step-definitions/when-i-select-option-select-list.md +2 -0
  49. package/examples/a11y-legacy-widget.html +34 -0
  50. package/examples/auth-state.html +42 -0
  51. package/examples/choice-controls.html +29 -0
  52. package/examples/clock.html +33 -0
  53. package/examples/datetime-fields.html +52 -0
  54. package/examples/downloads/webship-archive.zip +0 -0
  55. package/examples/downloads/webship-notes.txt +4 -0
  56. package/examples/downloads/webship-report.csv +4 -0
  57. package/examples/downloads.html +16 -0
  58. package/examples/element-selector-hint.html +16 -0
  59. package/examples/element-viewport.html +42 -0
  60. package/examples/field-states.html +27 -0
  61. package/examples/field-types.html +98 -0
  62. package/examples/fill-in-empty.html +26 -0
  63. package/examples/fill-unreachable.html +27 -0
  64. package/examples/iframe-inner.html +20 -0
  65. package/examples/iframe-nested.html +16 -0
  66. package/examples/iframe-newsletter.html +29 -0
  67. package/examples/iframe-order.html +26 -0
  68. package/examples/iframe-outer.html +15 -0
  69. package/examples/iframe.html +21 -0
  70. package/examples/javascript-errors.html +35 -0
  71. package/examples/links.html +1 -0
  72. package/examples/metatags.html +18 -0
  73. package/examples/mouse-and-pointer.html +83 -0
  74. package/examples/multi-value-fields.html +54 -0
  75. package/examples/native-dialogs.html +8 -0
  76. package/examples/network.html +83 -0
  77. package/examples/registered-names.html +15 -0
  78. package/examples/scroll-horizontal.html +50 -0
  79. package/examples/select-by-label.html +33 -0
  80. package/examples/selectors-position.html +29 -0
  81. package/examples/settle-budget.html +21 -0
  82. package/examples/sorted-tables.html +38 -0
  83. package/examples/storage.html +57 -0
  84. package/examples/text-matching.html +48 -0
  85. package/examples/text-order.html +25 -0
  86. package/examples/touch.html +22 -0
  87. package/examples/viewport-size.html +24 -0
  88. package/examples/viewport-top.html +36 -0
  89. package/examples/wait-conditions.html +69 -0
  90. package/examples/web-first.html +99 -0
  91. package/package.json +24 -2
  92. package/playwright.config.ts +3 -1
  93. package/tests/assets/catalog.xml +19 -0
  94. package/tests/assets/feed-namespaced.xml +13 -0
  95. package/tests/assets/sitemap.xml +14 -0
  96. package/tests/assets/webship-site-expected.yaml +21 -0
  97. package/tests/assets/webship-site.schema.json +46 -0
  98. package/tests/assets/webship-site.yaml +21 -0
  99. package/tests/check-api-launch-url.js +106 -0
  100. package/tests/check-assets.js +103 -0
  101. package/tests/check-attachments.js +105 -0
  102. package/tests/check-breakpoints.js +117 -0
  103. package/tests/check-clock.js +143 -0
  104. package/tests/check-config.js +90 -0
  105. package/tests/check-context.js +215 -0
  106. package/tests/check-dry-run.js +104 -0
  107. package/tests/check-examples.js +241 -0
  108. package/tests/check-exit-report.js +141 -0
  109. package/tests/check-javascript-errors.js +105 -0
  110. package/tests/check-must-fail.js +85 -0
  111. package/tests/check-paths.js +82 -0
  112. package/tests/check-report.js +119 -0
  113. package/tests/check-scaffold.js +246 -0
  114. package/tests/check-screenshots.js +117 -0
  115. package/tests/check-settle-verbs.js +137 -0
  116. package/tests/check-time-limit.js +104 -0
  117. package/tests/check-video.js +156 -0
  118. package/tests/check-world.js +167 -0
  119. package/tests/features/a11y.feature +18 -0
  120. package/tests/features/api-base-url.feature +25 -0
  121. package/tests/features/api-form-data.feature +18 -0
  122. package/tests/features/api-json-paths.feature +24 -0
  123. package/tests/features/api-response-contains.feature +21 -0
  124. package/tests/features/api-response-header-presence.feature +17 -0
  125. package/tests/features/api-response-header.feature +17 -0
  126. package/tests/features/api-saved-placeholders.feature +37 -0
  127. package/tests/features/api-step-definitions-individual.feature +1 -1
  128. package/tests/features/api-tables.feature +40 -0
  129. package/tests/features/auth-state.feature +32 -0
  130. package/tests/features/breakpoints.feature +25 -0
  131. package/tests/features/choice-controls.feature +35 -0
  132. package/tests/features/clock.feature +27 -0
  133. package/tests/features/complete-api-testing-examples.feature +1 -1
  134. package/tests/features/cookie.feature +9 -0
  135. package/tests/features/datetime-field-lookup.feature +29 -0
  136. package/tests/features/dialog.feature +27 -0
  137. package/tests/features/element-selector-hint.feature +14 -0
  138. package/tests/features/element.feature +47 -0
  139. package/tests/features/field-state.feature +21 -0
  140. package/tests/features/field.feature +104 -0
  141. package/tests/features/file-download.feature +64 -0
  142. package/tests/features/fill-in-empty-value.feature +41 -0
  143. package/tests/features/fill-reachable.feature +13 -0
  144. package/tests/features/iframe-nested.feature +43 -0
  145. package/tests/features/iframe.feature +83 -0
  146. package/tests/features/javascript-tolerated-errors.feature +20 -0
  147. package/tests/features/javascript.feature +47 -0
  148. package/tests/features/link.feature +11 -0
  149. package/tests/features/metatag.feature +38 -0
  150. package/tests/features/modal-open.feature +13 -0
  151. package/tests/features/mouse-and-pointer.feature +86 -0
  152. package/tests/features/multi-value-field-lookup.feature +30 -0
  153. package/tests/features/network-mocking.feature +80 -0
  154. package/tests/features/registered-names.feature +14 -0
  155. package/tests/features/responsive.feature +27 -0
  156. package/tests/features/scroll-horizontal.feature +55 -0
  157. package/tests/features/select-by-label.feature +31 -0
  158. package/tests/features/selector-files.feature +14 -0
  159. package/tests/features/selectors-position.feature +41 -0
  160. package/tests/features/selectors-table-header.feature +35 -0
  161. package/tests/features/settle-budget.feature +11 -0
  162. package/tests/features/sorted-tables.feature +19 -0
  163. package/tests/features/storage-quoted-values.feature +26 -0
  164. package/tests/features/storage.feature +98 -0
  165. package/tests/features/test--then--i-see-locator.feature +13 -0
  166. package/tests/features/test--then--i-should--see-text-in-element.feature +9 -1
  167. package/tests/features/test--then--the-field-should-contain-value.feature +8 -0
  168. package/tests/features/text-matching.feature +38 -0
  169. package/tests/features/text-order.feature +14 -0
  170. package/tests/features/touch.feature +21 -0
  171. package/tests/features/video.feature +1 -0
  172. package/tests/features/viewport-top.feature +13 -0
  173. package/tests/features/wait.feature +89 -0
  174. package/tests/features/web-first.feature +100 -0
  175. package/tests/features/xml-namespaces.feature +34 -0
  176. package/tests/features/xml.feature +96 -0
  177. package/tests/features/yaml.feature +75 -0
  178. package/tests/must-fail/api-json-paths.feature +21 -0
  179. package/tests/must-fail/api-response-contains.feature +23 -0
  180. package/tests/must-fail/api-response-header-presence.feature +17 -0
  181. package/tests/must-fail/api-response-header.feature +21 -0
  182. package/tests/must-fail/api-without-base-url.feature +11 -0
  183. package/tests/must-fail/assertions.feature +96 -0
  184. package/tests/must-fail/breakpoints.feature +15 -0
  185. package/tests/must-fail/choice-controls.feature +25 -0
  186. package/tests/must-fail/clock.feature +11 -0
  187. package/tests/must-fail/datetime-field.feature +10 -0
  188. package/tests/must-fail/element-selector-hint.feature +17 -0
  189. package/tests/must-fail/field-state.feature +20 -0
  190. package/tests/must-fail/fill-field.feature +30 -0
  191. package/tests/must-fail/iframe-text.feature +17 -0
  192. package/tests/must-fail/modal-open.feature +26 -0
  193. package/tests/must-fail/multi-value-field.feature +18 -0
  194. package/tests/must-fail/registered-names.feature +25 -0
  195. package/tests/must-fail/select-list.feature +15 -0
  196. package/tests/must-fail/selector-files.feature +10 -0
  197. package/tests/must-fail/sorted-tables.feature +20 -0
  198. package/tests/must-fail/storage-before-a-page.feature +13 -0
  199. package/tests/must-fail/text-matching.feature +16 -0
  200. package/tests/must-fail/text-order.feature +15 -0
  201. package/tests/must-fail/viewport-top.feature +20 -0
  202. package/tests/must-fail/waits.feature +51 -0
  203. package/tests/must-fail/yaml-numbers.feature +48 -0
  204. package/tests/reports/README.md +2 -2
  205. package/tests/step-definitions/a11y.steps.js +36 -23
  206. package/tests/step-definitions/action.steps.js +22 -8
  207. package/tests/step-definitions/api.steps.js +349 -67
  208. package/tests/step-definitions/assertion.steps.js +327 -63
  209. package/tests/step-definitions/auth.steps.js +15 -18
  210. package/tests/step-definitions/clock.steps.js +22 -0
  211. package/tests/step-definitions/debug.steps.js +8 -0
  212. package/tests/step-definitions/dialog.steps.js +9 -2
  213. package/tests/step-definitions/element.steps.js +135 -18
  214. package/tests/step-definitions/field.steps.js +523 -80
  215. package/tests/step-definitions/file-download.steps.js +74 -10
  216. package/tests/step-definitions/form.steps.js +76 -29
  217. package/tests/step-definitions/iframe.steps.js +89 -29
  218. package/tests/step-definitions/input.steps.js +26 -7
  219. package/tests/step-definitions/javascript.steps.js +64 -22
  220. package/tests/step-definitions/modal.steps.js +79 -13
  221. package/tests/step-definitions/navigation.steps.js +14 -0
  222. package/tests/step-definitions/network.steps.js +15 -5
  223. package/tests/step-definitions/response.steps.js +6 -4
  224. package/tests/step-definitions/responsive.steps.js +26 -33
  225. package/tests/step-definitions/screenshot.steps.js +26 -9
  226. package/tests/step-definitions/scroll.steps.js +20 -0
  227. package/tests/step-definitions/selectors.steps.js +104 -51
  228. package/tests/step-definitions/storage.steps.js +41 -16
  229. package/tests/step-definitions/table.steps.js +81 -6
  230. package/tests/step-definitions/video.steps.js +52 -55
  231. package/tests/step-definitions/wait.steps.js +209 -54
  232. package/tests/step-definitions/web-first.steps.js +69 -35
  233. package/tests/step-definitions/webship.js +807 -128
  234. package/tests/step-definitions/xml.steps.js +124 -28
  235. package/tests/step-definitions/yaml.steps.js +90 -46
  236. package/.scratch/commit.txt +0 -14
  237. package/.scratch/docs.py +0 -42
  238. package/.scratch/echo-server.js +0 -8
  239. package/.scratch/echo.js +0 -35
  240. package/.scratch/echo.pid +0 -1
  241. package/.scratch/features/cookies.feature +0 -22
  242. package/.scratch/http.pid +0 -1
  243. package/.scratch/https.pid +0 -1
  244. package/.scratch/issue.md +0 -49
  245. package/.scratch/one.js +0 -2
  246. package/.scratch/one.json +0 -280
  247. package/.scratch/patch.py +0 -163
  248. package/.scratch/pr.md +0 -30
@@ -2,7 +2,7 @@ version: 2.1
2
2
 
3
3
  defaults: &defaults
4
4
  docker:
5
- - image: cimg/node:20.20
5
+ - image: cimg/node:24
6
6
  environment:
7
7
  FORCE_COLOR: "1"
8
8
 
@@ -27,6 +27,15 @@ jobs:
27
27
  - run:
28
28
  name: Test
29
29
  command: npm test
30
+ - store_artifacts:
31
+ path: tests/reports
32
+ destination: cucumber-report
33
+ - store_artifacts:
34
+ path: screenshots
35
+ destination: screenshots
36
+ - store_artifacts:
37
+ path: videos
38
+ destination: videos
30
39
 
31
40
  workflows:
32
41
  version: 2
package/.drone.yml CHANGED
@@ -1,8 +1,10 @@
1
1
  # Drone CI for webship-js.
2
2
  #
3
- # Runs the full BDD suite inside the official Playwright container, so
4
- # chromium + every apt dependency are pre-installed. Anyone running a Drone
5
- # server can drop the repo in: enable in the UI and push.
3
+ # Runs the full BDD suite inside the official Playwright container of the
4
+ # version the install brings, so chromium + every apt dependency are
5
+ # pre-installed; `npx playwright install` gets the browser of a newer
6
+ # Playwright release when there is one. Anyone running a Drone server can
7
+ # drop the repo in: enable in the UI and push.
6
8
  #
7
9
  # Setup (full walkthrough in docs/16-ci-cd.md → "Drone CI"):
8
10
  # 1. Self-host Drone:
@@ -16,8 +18,6 @@
16
18
  # --restart=always --name=drone drone/drone:2
17
19
  # Plus at least one runner (docker runner is the common choice).
18
20
  # 2. Sign in at https://ci.example.com → activate webship-js.
19
- #
20
- # Drone Cloud (drone.io) is paid as of 2023 — self-host is the OSS path.
21
21
 
22
22
  kind: pipeline
23
23
  type: docker
@@ -35,7 +35,7 @@ trigger:
35
35
 
36
36
  steps:
37
37
  - name: test
38
- image: mcr.microsoft.com/playwright:v1.58.2-jammy
38
+ image: mcr.microsoft.com/playwright:v1.65.1-noble
39
39
  environment:
40
40
  FORCE_COLOR: "1"
41
41
  LAUNCH_URL: "http://localhost:8080"
@@ -57,7 +57,7 @@ steps:
57
57
  - failure
58
58
  commands:
59
59
  - apk add --no-cache tar
60
- - tar czf /artifacts/cucumber-report-${DRONE_BUILD_NUMBER}.tar.gz tests/reports screenshots || true
60
+ - tar czf /artifacts/cucumber-report-${DRONE_BUILD_NUMBER}.tar.gz tests/reports screenshots videos || true
61
61
  volumes:
62
62
  - name: artifacts
63
63
  path: /artifacts
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: Issue
3
+ about: Report a problem or propose an addition, change, update or fix
4
+ ---
5
+
6
+ ### Problem/Motivation
7
+
8
+ <!-- What is wrong or missing, with the exact step phrase, error text or value. -->
9
+
10
+ #### Steps to reproduce
11
+
12
+ <!-- 1. ... 2. ... 3. ... -->
13
+
14
+ ### Proposed resolution
15
+
16
+ <!-- What should change, naming the file, step or setting. -->
17
+
18
+ ### Checkpoints:
19
+ - [ ] File an issue
20
+ - [ ] Addition/Change/Update/Fix
21
+ - [ ] Testing to ensure no regression
22
+ - [ ] Automated unit testing coverage
23
+ - [ ] Automated functional testing coverage
24
+ - [ ] UX/UI designer responsibilities
25
+ - [ ] Readability
26
+ - [ ] Accessibility
27
+ - [ ] Performance
28
+ - [ ] Security
29
+ - [ ] Developer Documentation
30
+ - [ ] User Guide Documentation
31
+ - [ ] Reviewed by human
32
+ - [ ] Code review by maintainers
33
+ - [ ] Full testing and approval
34
+ - [ ] Credit contributors
35
+ - [ ] Review with the product owner
36
+ - [ ] Release notes snippet
37
+ - [ ] Release
@@ -0,0 +1,24 @@
1
+ <!-- What changes, in two or three plain sentences, and one line of proof (scenarios and steps run, results). -->
2
+
3
+ Closes #
4
+
5
+ ### Checkpoints:
6
+ - [ ] File an issue
7
+ - [ ] Addition/Change/Update/Fix
8
+ - [ ] Testing to ensure no regression
9
+ - [ ] Automated unit testing coverage
10
+ - [ ] Automated functional testing coverage
11
+ - [ ] UX/UI designer responsibilities
12
+ - [ ] Readability
13
+ - [ ] Accessibility
14
+ - [ ] Performance
15
+ - [ ] Security
16
+ - [ ] Developer Documentation
17
+ - [ ] User Guide Documentation
18
+ - [ ] Reviewed by human
19
+ - [ ] Code review by maintainers
20
+ - [ ] Full testing and approval
21
+ - [ ] Credit contributors
22
+ - [ ] Review with the product owner
23
+ - [ ] Release notes snippet
24
+ - [ ] Release
@@ -1,10 +1,27 @@
1
1
  name: Github Actions
2
2
 
3
- on: [push]
3
+ on:
4
+ push:
5
+ branches: [2.0.x]
6
+ pull_request:
7
+ branches: [2.0.x]
8
+ workflow_dispatch: {}
9
+
10
+ permissions:
11
+ contents: read
12
+
13
+ # The runs of a pull request share a group, so a newer push cancels the run
14
+ # it supersedes. Every other run (a push to 2.0.x, a run started by hand)
15
+ # gets a group of its own: it is never queued behind another run, and never
16
+ # cancelled.
17
+ concurrency:
18
+ group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
19
+ cancel-in-progress: true
4
20
 
5
21
  jobs:
6
22
  build:
7
23
  runs-on: ubuntu-latest
24
+ timeout-minutes: 45
8
25
 
9
26
  env:
10
27
  TEST_BASE_URL: http://localhost:8080
@@ -12,24 +29,104 @@ jobs:
12
29
 
13
30
  steps:
14
31
  - name: Checkout repository
15
- uses: actions/checkout@v3
32
+ uses: actions/checkout@v7
16
33
 
17
34
  - name: Set up Node.js
18
- uses: actions/setup-node@v3
35
+ uses: actions/setup-node@v7
19
36
  with:
20
37
  node-version: '20.x'
38
+ cache: npm
39
+ cache-dependency-path: package.json
21
40
 
22
41
  - name: Install dependencies
23
42
  run: npm install
24
43
 
44
+ - name: Check the HTML report
45
+ run: npm run test:report
46
+
25
47
  - name: Install Playwright browsers
26
48
  run: npx playwright install --with-deps chromium
27
49
 
50
+ - name: Check that a dry run prints no line for each skipped step
51
+ run: npm run test:dry-run
52
+
53
+ - name: Check that the relative API base URL follows the launch URL
54
+ run: npm run test:api-launch-url
55
+
56
+ - name: Check the step examples and the feature steps
57
+ run: npm run test:examples
58
+
59
+ - name: Check that a wait runs for the time the scenario gives it
60
+ run: npm run test:time-limit
61
+
62
+ - name: Check that a feature named on the command line runs alone
63
+ run: npm run test:paths
64
+
65
+ - name: Check that the print steps attach what they print to the report
66
+ run: npm run test:attachments
67
+
68
+ - name: Check that each JavaScript-error check counts its own kind
69
+ run: npm run test:js-errors
70
+
71
+ - name: Check that only a failed step leaves a failure screenshot
72
+ run: npm run test:screenshots
73
+
74
+ - name: Check that a step reads a file from the tests/assets of the project
75
+ run: npm run test:assets
76
+
77
+ - name: Check that a configuration with only the launch URL runs
78
+ run: npm run test:config
79
+
80
+ - name: Check the HTML report built at the end of a run
81
+ run: npm run test:exit-report
82
+
83
+ - name: Check that every step and tag reads one breakpoint registry
84
+ run: npm run test:breakpoints
85
+
86
+ - name: Check that a replaced browser context keeps what the scenario set up
87
+ run: npm run test:context
88
+
89
+ - name: Check the video files of the three recording modes
90
+ run: npm run test:video
91
+
92
+ - name: Check that a project extends the World and settles its own steps
93
+ run: npm run test:world
94
+
95
+ - name: Check the smart waits under a fake clock
96
+ run: npm run test:clock
97
+
98
+ - name: Check that a project step with a page-changing verb is followed by the settle
99
+ run: npm run test:settle-verbs
100
+
28
101
  - name: Start virtual server
29
102
  run: npm start &
30
103
 
31
104
  - name: Wait for server
32
- run: sleep 3
105
+ run: |
106
+ for i in $(seq 1 30); do
107
+ curl -s -o /dev/null "$TEST_BASE_URL/" && exit 0
108
+ sleep 1
109
+ done
110
+ echo "The server did not answer on $TEST_BASE_URL in 30 seconds" >&2
111
+ exit 1
112
+
113
+ - name: Check the failures that must fail and their messages
114
+ run: npm run test:must-fail
33
115
 
34
116
  - name: Run tests
35
117
  run: npm test
118
+
119
+ - name: Check the scaffold of a new project
120
+ run: npm run test:scaffold
121
+
122
+ - name: Upload the report, screenshots and videos
123
+ if: always()
124
+ uses: actions/upload-artifact@v7
125
+ with:
126
+ name: cucumber-report
127
+ path: |
128
+ tests/reports/
129
+ screenshots/
130
+ videos/
131
+ retention-days: 14
132
+ if-no-files-found: ignore
package/.gitlab-ci.yml CHANGED
@@ -1,12 +1,9 @@
1
- image: node:20
1
+ image: node:24
2
2
 
3
3
  variables:
4
4
  FORCE_COLOR: "1"
5
5
 
6
6
  before_script:
7
- - apt-get update -qq
8
- - apt-get upgrade -qqy
9
- - apt-get install -yqq vim links lynx git diffutils htop curl wget p7zip-full unzip zip sed gcc g++ make libfreetype6-dev libaio1 libaio-dev libonig-dev libpng-dev
10
7
  - npm install
11
8
  - npx playwright install --with-deps chromium
12
9
 
@@ -19,6 +16,14 @@ webship-js-test:
19
16
  - npm start &
20
17
  - sleep 3
21
18
  - npm test
19
+ artifacts:
20
+ name: cucumber-report
21
+ when: always
22
+ expire_in: 14 days
23
+ paths:
24
+ - tests/reports/
25
+ - screenshots/
26
+ - videos/
22
27
 
23
28
  only:
24
29
  refs:
@@ -1,10 +1,9 @@
1
1
  # Harness CI pipeline for webship-js (Pipeline-as-Code).
2
2
  #
3
- # Harness CI is part of the Harness Software Delivery Platform. The free
4
- # Developer plan includes 90 build credits/day on hosted Linux x86 builds —
5
- # enough for ~9 runs of the 9-minute suite per day. After signup, point a
6
- # Git Sync connector at this repo and pick `.harness/webship-js-pipeline.yml`
7
- # as the pipeline definition.
3
+ # Harness CI is part of the Harness Software Delivery Platform. For the free
4
+ # plan and its build credits, see the Harness pricing page: they change over
5
+ # time. After signup, point a Git Sync connector at this repo and pick
6
+ # `.harness/webship-js-pipeline.yml` as the pipeline definition.
8
7
  #
9
8
  # Full walkthrough: docs/16-ci-cd.md → "Harness CI".
10
9
 
@@ -92,7 +91,7 @@ pipeline:
92
91
  image: plugins/s3
93
92
  settings:
94
93
  bucket: webship-js-reports
95
- source: tests/reports/cucumber_report.{html,pdf,json}
94
+ source: "{tests/reports,screenshots,videos}/**"
96
95
  target: harness/$DRONE_BUILD_NUMBER/
97
96
  access_key: <+secrets.getValue("aws_access_key")>
98
97
  secret_key: <+secrets.getValue("aws_secret_key")>
@@ -1,7 +1,7 @@
1
1
  # Semaphore CI for webship-js.
2
2
  #
3
- # Free tier: 1,300 build-minutes per month on `e1-standard-2` (2 vCPU, 4 GB).
4
- # Open-source projects qualify for additional minutes via the Startup plan.
3
+ # For the free tier and the plans, see the Semaphore pricing page: they change
4
+ # over time.
5
5
  #
6
6
  # Setup (full walkthrough in docs/16-ci-cd.md → "Semaphore"):
7
7
  # 1. semaphoreci.com → sign up with GitHub.
@@ -22,7 +22,7 @@ global_job_config:
22
22
  - { name: LAUNCH_URL, value: "http://localhost:8080" }
23
23
  prologue:
24
24
  commands:
25
- - sem-version node 20
25
+ - sem-version node 24
26
26
  - checkout
27
27
  - cache restore node-modules-$(checksum package.json)
28
28
  - cache restore ms-playwright
@@ -50,9 +50,6 @@ blocks:
50
50
  epilogue:
51
51
  always:
52
52
  commands:
53
- - artifact push job tests/reports/cucumber_report.html --expire-in 30d || true
54
- - artifact push job tests/reports/cucumber_report.pdf --expire-in 30d || true
55
- - artifact push job tests/reports/cucumber_report.json --expire-in 30d || true
56
- on_failure:
57
- commands:
58
- - artifact push job screenshots --expire-in 30d || true
53
+ - artifact push job tests/reports --expire-in 30d || true
54
+ - artifact push job screenshots --expire-in 30d || true
55
+ - artifact push job videos --expire-in 30d || true
@@ -11,8 +11,8 @@
11
11
  // TeamCity will offer to generate this file the first time; we ship
12
12
  // a hand-crafted version below.
13
13
  //
14
- // Free tier: 600 build-minutes / month + 1 build agent + 100 build configs.
15
- // The 9-minute suite fits ~66 runs / month.
14
+ // For the free tier of TeamCity Cloud and its limits, see the TeamCity
15
+ // pricing page: they change over time.
16
16
 
17
17
  import jetbrains.buildServer.configs.kotlin.v2019_2.*
18
18
  import jetbrains.buildServer.configs.kotlin.v2019_2.buildSteps.script
@@ -55,7 +55,7 @@ object WebshipJsTest : BuildType({
55
55
  curl -sf http://localhost:8080/ > /dev/null
56
56
  npm test
57
57
  """.trimIndent()
58
- dockerImage = "mcr.microsoft.com/playwright:v1.58.2-jammy"
58
+ dockerImage = "mcr.microsoft.com/playwright:v1.65.1-noble"
59
59
  dockerPull = true
60
60
  dockerRunParameters = "--user root:root --network host"
61
61
  }
@@ -80,11 +80,12 @@ object WebshipJsTest : BuildType({
80
80
  }
81
81
 
82
82
  artifactRules = """
83
- tests/reports/cucumber_report.html
84
- tests/reports/cucumber_report.pdf
85
- tests/reports/cucumber_report.json
83
+ tests/reports/** => tests/reports
86
84
  screenshots/** => screenshots
85
+ videos/** => videos
87
86
  """.trimIndent()
87
+ // Keep the report of a failed run too.
88
+ publishArtifacts = PublishMode.ALWAYS
88
89
 
89
90
  requirements {
90
91
  contains("os.name", "Linux")
package/.travis.yml CHANGED
@@ -3,7 +3,7 @@ os: linux
3
3
  dist: jammy
4
4
 
5
5
  node_js:
6
- - "20"
6
+ - "24"
7
7
 
8
8
  env:
9
9
  global:
@@ -32,6 +32,11 @@ before_script:
32
32
  script:
33
33
  - npm test
34
34
 
35
+ # Travis CI keeps no build artifacts of its own: the report, the screenshots
36
+ # and the videos (tests/reports/, screenshots/, videos/) stay in the build
37
+ # log only. To keep them, upload them to storage of your own in an
38
+ # after_script step, or use another provider of docs/16-ci-cd.md.
39
+
35
40
  notifications:
36
41
  email:
37
42
  on_success: never
package/AGENTS.md CHANGED
@@ -109,7 +109,7 @@ step definitions. Critical takeaways:
109
109
 
110
110
  ## Source map
111
111
 
112
- Step definitions: `tests/step-definitions/` — 417 steps across 36
112
+ Step definitions: `tests/step-definitions/` — 428 steps across 36
113
113
  `*.steps.js` files, all auto-loaded. The `webship.js` file there is the
114
114
  single canonical entry point — World, hooks, init script, and shared
115
115
  helpers (`smartSettle`, `waitForPageLoad`, `buildSelector`, `gotoUrl`,
package/CLAUDE.md CHANGED
@@ -38,6 +38,26 @@ suite — nearly every bundled feature loads a static fixture from `examples/`.
38
38
  | `npm run test:fast` | `SLOW_MO=0`. |
39
39
  | `npm run test:chromium` / `:firefox` / `:webkit` | Pick the browser (same as `BROWSER=…`). |
40
40
  | `npx cucumber-js --dry-run` | Ambiguity / undefined-step check. Run this before declaring done. |
41
+ | `npm run test:examples` | No browser: every step definition is documented with at least five `Example #n:` blocks that use it, every `Example #n:` step and every feature step resolves to exactly one definition. |
42
+ | `npm run test:attachments` | Needs browsers, no server: the steps that print what they found (the accessibility print steps) attach the same text to their step in the JSON report. |
43
+ | `npm run test:must-fail` | Runs the scenarios of `tests/must-fail/` (they must fail) and checks each failure message: what was looked for, the page, a hint. Needs `npm start`. |
44
+ | `npm run test:api-launch-url` | Needs browsers, no server of its own: the relative API base URL (`Given the API base URL is "/"`) is joined to `worldParameters.launchUrl`. |
45
+ | `npm run test:paths` | No browser: a feature or a scenario (`file:line`) named on the command line runs alone; naming none runs the whole suite. |
46
+ | `npm run test:settle-verbs` | A project's own step whose words carry a page-changing verb (add, log out, enter, open, delete, save) is followed by the settle; `wait for ajax to finish` reads in lower case. |
47
+ | `npm run test:config` | A `cucumber.js` whose `worldParameters` carry only the launch URL runs a scenario green and the run ends by itself. |
48
+ | `npm run test:exit-report` | Needs browsers, no server: the HTML report built at the end of a run is built once with `--parallel`, from a JSON report written elsewhere, and says so in one line when there is none. |
49
+ | `npm run test:world` | A project World that extends `PlaywrightWorld` keeps the viewport tag and `this.smartSettle()`; a World that replaces it is reported. |
50
+ | `npm run test:clock` | Under a fake clock a navigation and a press settle when the page is quiet; a clock step on a clock nobody installed says so. |
51
+ | `npm run test:video` | The video files of the `on`, `on-failure` and `off` modes: final names in lower case, no temporary file left, the printed path is the saved one, reserved names kept, stopped recordings named by the pattern. |
52
+ | `npm run test:context` | A step that replaces the browser context (restore an auth state, start / stop a video) keeps the viewport, the smart waits, the cookies, JavaScript-error capture and the request log. |
53
+ | `npm run test:breakpoints` | The `@mobile` / `@desktop` tags, `set the viewport to the "…" breakpoint` and `viewing the site on a … screen` read one breakpoint registry (config, `WEBSHIP_SELECTORS_BREAKPOINTS`, `default: true`). |
54
+ | `npm run test:report` | No server: generates an HTML report from a small JSON and checks it — no third-party icon, the project's own version, the place of execution. |
55
+ | `npm run test:dry-run` | No server: a dry run with the pretty formatter prints the steps, `? undefined` and the summary, with no `- skipped` line for each hook or step. |
56
+ | `npm run test:time-limit` | No server: the waits that take a length and the web-first `within N seconds` matchers run past `WEBSHIP_STEP_TIMEOUT` and pass, or fail with their own message. |
57
+ | `npm run test:js-errors` | No server: with warnings captured, the errors check counts errors only and the warnings check warnings only; what a check did not read is reported at the end of the scenario. |
58
+ | `npm run test:assets` | No server: in a project of its own, the attach, XML-file and YAML-file steps read its `tests/assets/` and paths from its root; a missing file fails plainly. |
59
+ | `npm run test:screenshots` | No server: only a failed step leaves a failure screenshot (a skipped or pending one does not). |
60
+ | `npm run test:scaffold` | Scaffolds a new project, runs its first `npm test` and one feature named on the command line. |
41
61
  | `npm run generate-reports` | HTML (+ optional PDF) report from `tests/reports/cucumber_report.json`. |
42
62
 
43
63
  Targeting a subset:
@@ -53,10 +73,9 @@ HEADLESS=false SLOW_MO=800 npx cucumber-js tests/features/x.feature # watch a
53
73
  ```
54
74
 
55
75
  Env vars: `LAUNCH_URL`, `BROWSER`, `HEADLESS`, `SLOW_MO`, `FORCE_COLOR`,
56
- `WEBSHIP_AUTO_SETTLE`, `WEBSHIP_STEP_TIMEOUT`, `WEBSHIP_REPORT_DISABLE`, `WEBSHIP_REPORT_ARGS`,
76
+ `WEBSHIP_AUTO_SETTLE`, `WEBSHIP_STEP_TIMEOUT`, `WEBSHIP_REPORT_DISABLE`, `WEBSHIP_REPORT_ARGS`, `WEBSHIP_REPORT_JSON`,
57
77
  `WEBSHIP_FILTER_HOOK_LINES`, `WEBSHIP_SCREENSHOT_*`, `WEBSHIP_VIDEO*`,
58
- `WEBSHIP_JS_ERROR_*`, `WEBSHIP_SELECTORS_OFFSET`,
59
- `WEBSHIP_SELECTORS_BREAKPOINTS`, `DIFFY_*`. Every one of them mirrors a
78
+ `WEBSHIP_JS_ERROR_*`, `WEBSHIP_SELECTORS_BREAKPOINTS`, `DIFFY_*`. Every one of them mirrors a
60
79
  `worldParameters` key in `cucumber.js` — that file is the annotated
61
80
  reference; read it before inventing a new knob.
62
81
 
@@ -91,18 +110,38 @@ Everything shared lives here; every `*.steps.js` does
91
110
  Playwright's 30 s default so locator timeouts reach our try/catch
92
111
  wrappers and testers see a friendly message, not "function timed out".
93
112
  The 45 s in `cucumber.js` exists for the same reason; keep them aligned.
94
- * **The init script** installed via `context.addInitScript()` in
95
- `openBrowser()` — monkey-patches `fetch`, `XMLHttpRequest.send`,
96
- `setTimeout`/`clearTimeout` and attaches a `MutationObserver` to
97
- maintain `window.__webshipAjaxCount`, `__webshipPendingTimers`,
98
- `__webshipLastMutation`. This is the substrate the whole wait policy
99
- stands on. **Never strip it.**
100
- * **Hooks** — `Before({order:5})` opens the browser (merging
101
- `recordVideo` context options when video is on); `After({order:5})`
113
+ A step whose length the scenario gives (`I wait 2 minutes`, `within N
114
+ seconds`) takes `OWN_LENGTH` from `wait.steps.js` (no cucumber limit)
115
+ and bounds itself with `withinTimeLimit` instead.
116
+ * **The init script** (`smartWaitProbes`) installed via
117
+ `context.addInitScript()` in `openContext()` — monkey-patches `fetch`,
118
+ `XMLHttpRequest.send`, `setTimeout`/`clearTimeout` and attaches a
119
+ `MutationObserver` to maintain `window.__webshipAjaxCount`,
120
+ `__webshipPendingTimers`, `__webshipLastMutation`. This is the substrate
121
+ the whole wait policy stands on. **Never strip it.**
122
+ * **One way to open a browser context** — `openBrowser()` launches the
123
+ browser and calls `openContext()`, which applies the context options,
124
+ the scenario's viewport tag and video recording, the init script, and
125
+ every setup registered with `onNewPage()` (JavaScript-error listeners,
126
+ the response tracker, the request log, a pending dialog handler). A step
127
+ that needs a new context (restore an auth state, start or stop a video)
128
+ calls `replaceContext()`, never `browser.newContext()` directly — or the
129
+ new page silently loses the smart waits, the viewport and the listeners.
130
+ * **Hooks** — they run in the order they are registered (cucumber-js has
131
+ no `order` option; After hooks run in reverse), and `webship.js` is
132
+ loaded before any other hook is registered (every step file with hooks
133
+ requires it at its top): its `Before` opens the browser (merging
134
+ `recordVideo` context options when video is on) before any other
135
+ `Before`; its `After`
102
136
  captures the video path *before* closing the context, saves/deletes per
103
137
  mode, then closes the browser; `BeforeStep` resolves `[relative:…]` date
104
138
  tokens in step text, doc strings, and data-table cells; `AfterStep`
105
139
  runs the auto-settle.
140
+ * **`PlaywrightWorld` is exported** so a project extends it
141
+ (`setWorldConstructor(class extends PlaywrightWorld { … })`) instead of
142
+ replacing it; a World that does not extend it is reported once at the
143
+ start of the run. Its `smartSettle(budget = 1500)` method is the settle a
144
+ custom step calls after changing the page.
106
145
  * **Shared helpers** (exported): `smartSettle`, `waitForPageLoad`,
107
146
  `buildSelector`, `gotoUrl`, `fillField`, `getLocatorText`, `pad`,
108
147
  the modal probes (`getModalSelector`, `getModalLocator`,
@@ -110,11 +149,15 @@ Everything shared lives here; every `*.steps.js` does
110
149
  helpers (`resolveRelativeDate`, `parseRelativeOffset`,
111
150
  `formatRelativeDate`), and the error builders (`friendly`, `humanize`).
112
151
  * **Two process-level side effects**: a stdout/stderr filter that strips
113
- noisy `✔ Before # …` hook lines from cucumber's failure dump
114
- (`WEBSHIP_FILTER_HOOK_LINES=off` to disable), and a `process.on('exit')`
152
+ noisy `✔ Before # …` hook lines from cucumber's failure dump, and in a
153
+ dry run (`--dry-run`, `-d`) the pretty formatter's `- skipped` line for
154
+ every hook and step (`WEBSHIP_FILTER_HOOK_LINES=off` to disable), and a `process.on('exit')`
115
155
  hook that auto-generates the HTML report via `bin/generate-reports`
116
156
  (`WEBSHIP_REPORT_DISABLE=1` to disable, `WEBSHIP_REPORT_ARGS` to pass
117
- flags).
157
+ flags). It runs only in the process that runs cucumber-js, never in a
158
+ `--parallel` worker, and reads the JSON report the run wrote
159
+ (`WEBSHIP_REPORT_JSON`, else the `json:` formatter of the command line or
160
+ of `cucumber.js`, else `tests/reports/cucumber_report.json`).
118
161
 
119
162
  ### 2.3 Config layering
120
163
 
@@ -256,7 +299,7 @@ Some pairs look similar but cover different domains. NEVER merge:
256
299
 
257
300
  ## 5. File organisation
258
301
 
259
- 417 built-in steps across 36 step files. Cucumber auto-loads every
302
+ 428 built-in steps across 36 step files. Cucumber auto-loads every
260
303
  `*.steps.js` in `tests/step-definitions/`.
261
304
 
262
305
  ```
@@ -264,15 +307,15 @@ tests/step-definitions/
264
307
  ├── webship.js # World, hooks, init script, shared helpers — see §2.2. Not a steps file.
265
308
  ├── a11y.steps.js (30) # axe-core WCAG audits + POUR hygiene probes (axe loaded lazily)
266
309
  ├── action.steps.js (7) # press / click / follow / attach file (actOrExplain lives here)
267
- ├── api.steps.js (22) # REST long form — base URL, headers, query, body, JSON Pointer
310
+ ├── api.steps.js (24) # REST long form — base URL, headers, query, body, JSON Pointer
268
311
  ├── assertion.steps.js (14) # see / not see, in row, in element, response, count
269
312
  ├── auth.steps.js (3) # storageState save / restore / clear
270
313
  ├── clock.steps.js (7) # page.clock — install / advance / pause / set
271
314
  ├── cookie.steps.js (12) # cookie exists / equals / contains
272
315
  ├── debug.steps.js (2) # print URL / last response
273
316
  ├── dialog.steps.js (8) # native alert / confirm / prompt handlers
274
- ├── element.steps.js (19) # focus / scroll-to / dispatch / count / position
275
- ├── field.steps.js (27) # field, checkbox, radio, select-list state assertions
317
+ ├── element.steps.js (20) # focus / scroll-to / dispatch / count / position
318
+ ├── field.steps.js (35) # field, checkbox, radio, select-list state assertions
276
319
  ├── file-download.steps.js (8) # download capture + filename / mime / path assertions
277
320
  ├── form.steps.js (13) # fill / select / additionally select / check / uncheck / radio
278
321
  ├── iframe.steps.js (10) # frameLocator switch + frame-scoped interactions
@@ -299,7 +342,7 @@ tests/step-definitions/
299
342
  ├── xml.steps.js (20) # XPath equals / contains / count / attr
300
343
  └── yaml.steps.js (38) # multi-doc, types, numerics, JSON Schema, diff
301
344
 
302
- tests/features/ # 73 .feature files
345
+ tests/features/ # 122 .feature files
303
346
  tests/selectors/ # 26 JSON presets + _canonical-keys.json
304
347
  tests/assets/ # upload fixtures (pdf, png)
305
348
  examples/ # static HTML fixtures served by `npm start`
@@ -328,8 +371,10 @@ Conditions 4/5/6 are evaluated atomically in one `waitForFunction`, so a
328
371
  late-firing `setTimeout` that mutates the DOM re-arms the wait.
329
372
 
330
373
  Auto-settle hook: `AfterStep` runs `smartSettle(page, 1500)` after every
331
- step whose text matches `STATE_MUTATING_STEP` (click / press / fill /
332
- select / check / attach / reload / navigate / …). This is what makes
374
+ step whose own words (quoted arguments left out) match
375
+ `STATE_MUTATING_STEP` (click / press / fill / select / check / attach /
376
+ reload / navigate, and the verbs projects use: add / open / delete / save /
377
+ enter / log in / log out / …). This is what makes
333
378
  `When I click "X" Then I should see "Y"` work without an explicit wait.
334
379
  Disable per-run with `WEBSHIP_AUTO_SETTLE=off`. If a wait is flaky only in
335
380
  CI, raise the budget — never add a static sleep.
@@ -393,7 +438,7 @@ into one reference. Internalise these:
393
438
 
394
439
  Tag conventions live in `docs/15-tag-conventions.md` — `@critical`,
395
440
  `@smoke`, `@auth`, `@security`, `@a11y`, `@i18n`, `@perf`, `@flaky`,
396
- `@wip`, `@desktop`/`@mobile`, `@external`, `@auth-setup`, plus the
441
+ `@wip`, `@desktop`/`@mobile`, `@touch`, `@external`, `@auth-setup`, plus the
397
442
  recording tags `@video` / `@no-video` and the JS-error tags `@js-fail` /
398
443
  `@js-warn` / `@js-off`.
399
444
 
@@ -481,7 +526,7 @@ the workspace repos and installed into `~/.claude/`:
481
526
 
482
527
  | Agent | Model | Scope |
483
528
  | --- | --- | --- |
484
- | `agent-webship-js` | opus | The full specialist. Scaffold (Node.js or DDEV) → author `.feature` files → write custom steps → run → debug → HTML/PDF report. Carries a distilled copy of the whole step catalog, the BBR/selector/tag sections, the 20-recipe cookbook, Varbase learnings, and recipes AI-1…AI-5. Use for anything non-trivial. |
529
+ | `agent-webship-js` | opus | The full specialist. Scaffold (Node.js or DDEV) → author `.feature` files → write custom steps → run → debug → HTML/PDF report. Carries a distilled copy of the whole step catalog, the BBR/selector/tag sections, the 20-recipe cookbook, project learnings, and recipes AI-1…AI-5. Use for anything non-trivial. |
485
530
  | `webship-ai-agent` | sonnet | The loop-until-green worker for a consumer project: read available steps → write/fix scenarios → run → fix root cause → iterate to zero failures. Lighter, autonomous, Drupal/DDEV-flavoured (`NN-NN-NN-name.feature`, `https://<project>.ddev.site`). |
486
531
 
487
532
  ### Skills (slash commands)
@@ -519,7 +564,7 @@ copies be re-derived.
519
564
  3. **Known drift to be aware of, not to "fix" here:** the agents and the
520
565
  `/webship-js-run` skill reference a `worldParameters.users` registry and
521
566
  an auth helper built on it. There is no `users` key in this repo's
522
- `cucumber.js` or in `bin/init-webship.js` — it is a Varbase-project
567
+ `cucumber.js` or in `bin/init-webship.js` — it is a project-level
523
568
  convention layered on top. If a user asks about `users`, say so rather
524
569
  than adding the key on the agents' say-so.
525
570
  4. **Guardrails they already carry** (so don't re-litigate them): never
package/Jenkinsfile CHANGED
@@ -1,7 +1,9 @@
1
1
  // Jenkins declarative pipeline for webship-js.
2
2
  //
3
3
  // Runs the full BDD suite against an http-server fixture on port 8080.
4
- // Uses the official Playwright image so chromium + all apt deps are baked in.
4
+ // Uses the official Playwright image of the version the install brings, so
5
+ // chromium + all apt deps are baked in; `npx playwright install` below gets
6
+ // the browser of a newer Playwright release when there is one.
5
7
  //
6
8
  // Requirements on the Jenkins controller:
7
9
  // - Docker Pipeline plugin (built into the "suggested plugins" install)
@@ -13,7 +15,7 @@
13
15
  pipeline {
14
16
  agent {
15
17
  docker {
16
- image 'mcr.microsoft.com/playwright:v1.58.2-jammy'
18
+ image 'mcr.microsoft.com/playwright:v1.65.1-noble'
17
19
  args '-u root:root'
18
20
  }
19
21
  }
@@ -47,7 +49,7 @@ pipeline {
47
49
  }
48
50
  post {
49
51
  always {
50
- archiveArtifacts artifacts: 'tests/reports/cucumber_report.html,tests/reports/cucumber_report.pdf,tests/reports/cucumber_report.json,screenshots/**/*',
52
+ archiveArtifacts artifacts: 'tests/reports/**/*,screenshots/**/*,videos/**/*',
51
53
  allowEmptyArchive: true
52
54
  }
53
55
  }
package/README.md CHANGED
@@ -18,8 +18,20 @@ All you need to know is at [webship-js Docs](https://webship.co/docs/webship-js/
18
18
  npm install webship-js
19
19
  ```
20
20
 
21
+ The install script of the package scaffolds the test project. When npm skips it (npm warns that webship-js has "install scripts not yet covered by allowScripts", or `--ignore-scripts` is set), scaffold it with:
22
+
23
+ ```
24
+ npx init-webship-js
25
+ ```
26
+
27
+ `npm install-scripts approve webship-js` lets the install script run on the next installs.
28
+
21
29
  ## Automated Functional Acceptance Testing
22
30
 
31
+ The install scaffolds the test project (`cucumber.js`, `playwright.config.ts`, `tests/`) with a starter feature that opens the home page of your site:
32
+
23
33
  ```
24
- npm test
34
+ LAUNCH_URL=https://your-site.example npm test
25
35
  ```
36
+
37
+ Without `LAUNCH_URL` the suite opens `http://localhost:8080`.