@tea-agent/loop-agent 0.35.1-beta.0 → 0.35.1-beta.1

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 (168) hide show
  1. package/AGENTS.md +110 -108
  2. package/CHANGELOG.md +16 -26
  3. package/README.md +165 -165
  4. package/bin/agent-worker.js +0 -0
  5. package/bin/loop-agent.js +57 -21
  6. package/dist/application/task-lifecycle/advance.js +0 -1
  7. package/dist/build-stamp.json +6 -0
  8. package/dist/cli/program.js +2 -2
  9. package/dist/commands/cursor-prompt.js +6 -6
  10. package/dist/commands/init-upgrade.js +19 -351
  11. package/dist/commands/init.js +67 -14
  12. package/dist/commands/loop-benchmark.js +11 -11
  13. package/dist/commands/pi-reuse-benchmark.js +16 -16
  14. package/dist/commands/run-dag-progress.js +0 -14
  15. package/dist/commands/task-advance.js +3 -33
  16. package/dist/shared/operator/capabilities.js +1 -38
  17. package/dist/shared/package-metadata.js +32 -0
  18. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  19. package/dist/worker/console/chat/pi-runtime.js +25 -41
  20. package/dist/worker/console/chat/routes.js +4 -27
  21. package/dist/worker/console/operation-runner.js +0 -24
  22. package/dist/worker/console/operator-actions.js +0 -58
  23. package/dist/worker/console/static/assets/index-fsjzREob.js +56 -0
  24. package/dist/worker/console/static/assets/{index-Dups4sSM.css → index-hJqCPs_g.css} +1 -1
  25. package/dist/worker/console/static/index.html +2 -2
  26. package/dist/worker/console/static-src/operator-chat/useChatSessions.js +2 -13
  27. package/dist/worker/console/static-src/operator-chat/useComposer.js +7 -30
  28. package/dist/worker/loop-agent/loop-agent-client.js +13 -0
  29. package/dist/worker/observe/static/copy.js +67 -67
  30. package/dist/worker/observe/static/dag-layout.d.ts +36 -36
  31. package/dist/worker/observe/static/dom.js +220 -220
  32. package/dist/worker/observe/static/relations.js +133 -133
  33. package/dist/worker/observe/static/run-processing.js +148 -148
  34. package/dist/worker/observe/static/views/batch.js +227 -227
  35. package/dist/worker/observe/static/views/failures.js +143 -143
  36. package/dist/worker/observe/static/views/feature.js +492 -492
  37. package/dist/worker/observe/static/views/run.js +453 -453
  38. package/dist/worker/observe/static/views/shell.js +7 -7
  39. package/dist/worker/observe/static/views/timeline.js +163 -163
  40. package/dist/workflows/dag/canvas-observer.js +275 -275
  41. package/dist/workflows/dag/contract-output-registry.js +14 -0
  42. package/dist/workflows/dag/contract-validator-registrations.js +8 -0
  43. package/dist/workflows/dag/dynamic-runtime/shared.js +9 -1
  44. package/dist/workflows/dag/frontend-implementation-contract.js +233 -39
  45. package/dist/workflows/dag/frontend-prewrite-gate.js +364 -61
  46. package/dist/workflows/dag/frontend-repair.js +219 -18
  47. package/dist/workflows/dag/frontend-verification-trace.js +47 -32
  48. package/dist/workflows/dag/init-hybrid.js +41 -24
  49. package/dist/workflows/dag/node-execution.js +89 -0
  50. package/dist/workflows/dag/runner.js +52 -3
  51. package/dist/workflows/dag/scheduler.js +98 -3
  52. package/dist/workflows/dag/types.js +23 -2
  53. package/docs/architecture/evolution.md +73 -73
  54. package/docs/architecture/system-overview.md +100 -100
  55. package/docs/architecture/worker-and-feature.md +122 -122
  56. package/docs/skills/README.md +7 -7
  57. package/docs/templates/adr.md +60 -60
  58. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  59. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  60. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  61. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  62. package/docs/templates/agent-dag-report.schema.json +473 -473
  63. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  64. package/docs/templates/backend-test-result.schema.json +99 -99
  65. package/docs/templates/evaluation/agents-map-slim-v1.md +87 -87
  66. package/docs/templates/evaluation/agents-map-verbose-v0.md +153 -153
  67. package/docs/templates/feature-spec.md +53 -53
  68. package/docs/templates/frontend-design-contract.md +42 -42
  69. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  70. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  71. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  72. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  73. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  74. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  75. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  76. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  77. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  78. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  79. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  80. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  81. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  82. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  83. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  84. package/docs/templates/frontend-eval/metrics.md +138 -138
  85. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  86. package/docs/templates/frontend-task-constraints.md +35 -35
  87. package/docs/templates/frontend-task-requirement.md +70 -70
  88. package/docs/templates/init-evolution-review.md +35 -35
  89. package/docs/templates/init-managed-agents.md +154 -156
  90. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  91. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  92. package/docs/templates/knowledge-sync-dag.json +178 -178
  93. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  94. package/docs/templates/product-line/closeout.yaml +9 -9
  95. package/docs/templates/product-line/design.md +13 -13
  96. package/docs/templates/product-line/links.md +10 -10
  97. package/docs/templates/product-line/requirement.md +17 -17
  98. package/docs/templates/product-line/test-plan.md +7 -7
  99. package/docs/templates/project-start-checklist.md +9 -9
  100. package/docs/templates/qa-report.md +48 -48
  101. package/docs/templates/sprint-contract.md +29 -29
  102. package/docs/templates/worker-dogfood-evidence.md +80 -80
  103. package/docs/templates/worker-dogfood-setup.md +68 -68
  104. package/harness.json +2 -5
  105. package/package.json +2 -2
  106. package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
  107. package/scripts/kb-graph-incremental-prepare.mjs +0 -0
  108. package/scripts/kb-graph-materialize.mjs +105 -105
  109. package/scripts/kb-graph-promote.mjs +164 -164
  110. package/scripts/kb-query.mjs +554 -554
  111. package/skills/agent-worker/SKILL.md +48 -48
  112. package/skills/agent-worker/references/agent-worker-operator.md +159 -159
  113. package/skills/ai-engineering-context/SKILL.md +48 -48
  114. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +0 -0
  115. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +0 -0
  116. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +0 -0
  117. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +0 -0
  118. package/skills/analyze-product-requirements/scripts/compute-source-identity.mjs +0 -0
  119. package/skills/analyze-product-requirements/scripts/test-validators.mjs +0 -0
  120. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +0 -0
  121. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +0 -0
  122. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +0 -0
  123. package/skills/browser-tools/browser-content.js +103 -103
  124. package/skills/browser-tools/browser-cookies.js +35 -35
  125. package/skills/browser-tools/browser-eval.js +53 -53
  126. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  127. package/skills/browser-tools/browser-nav.js +44 -44
  128. package/skills/browser-tools/browser-pick.js +162 -162
  129. package/skills/browser-tools/browser-screenshot.js +34 -34
  130. package/skills/browser-tools/browser-start.js +86 -86
  131. package/skills/browser-tools/package-lock.json +2556 -2556
  132. package/skills/browser-tools/package.json +19 -19
  133. package/skills/code-review-core/SKILL.md +20 -20
  134. package/skills/codebase-scout/SKILL.md +19 -19
  135. package/skills/grill-me/SKILL.md +10 -10
  136. package/skills/local-jacoco-coverage/scripts/run-coverage-analysis.sh +0 -0
  137. package/skills/local-jacoco-coverage/scripts/start-jacoco-agent.sh +0 -0
  138. package/skills/loop-agent/SKILL.md +0 -1
  139. package/skills/loop-agent/references/command-reference.md +639 -641
  140. package/skills/loop-agent/references/docs-converge.md +126 -126
  141. package/skills/loop-agent/references/learned/README.md +21 -21
  142. package/skills/loop-agent/references/pi-prompt.md +23 -23
  143. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  144. package/skills/playwright-cli/references/element-attributes.md +23 -23
  145. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  146. package/skills/playwright-cli/references/request-mocking.md +87 -87
  147. package/skills/playwright-cli/references/running-code.md +241 -241
  148. package/skills/playwright-cli/references/session-management.md +225 -225
  149. package/skills/playwright-cli/references/storage-state.md +275 -275
  150. package/skills/playwright-cli/references/test-generation.md +433 -433
  151. package/skills/requesting-code-review/SKILL.md +101 -101
  152. package/skills/requesting-code-review/code-reviewer.md +168 -168
  153. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  154. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  155. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  156. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  157. package/skills/systematic-debugging/find-polluter.sh +63 -63
  158. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  159. package/skills/systematic-debugging/test-academic.md +14 -14
  160. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  161. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  162. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  163. package/skills/using-git-worktrees/SKILL.md +215 -215
  164. package/skills/verification-before-completion/SKILL.md +154 -154
  165. package/skills/webapp-testing/SKILL.md +19 -19
  166. package/dist/worker/console/operation-wait.js +0 -241
  167. package/dist/worker/console/static/assets/index-SjjjZnV3.js +0 -56
  168. package/dist/worker/console/static-src/operator-chat/slash-palette-nav.js +0 -141
@@ -1,87 +1,87 @@
1
- # Request Mocking
2
-
3
- Intercept, mock, modify, and block network requests.
4
-
5
- ## CLI Route Commands
6
-
7
- ```bash
8
- # Mock with custom status
9
- playwright-cli route "**/*.jpg" --status=404
10
-
11
- # Mock with JSON body
12
- playwright-cli route "**/api/users" --body='[{"id":1,"name":"Alice"}]' --content-type=application/json
13
-
14
- # Mock with custom headers
15
- playwright-cli route "**/api/data" --body='{"ok":true}' --header="X-Custom: value"
16
-
17
- # Remove headers from requests
18
- playwright-cli route "**/*" --remove-header=cookie,authorization
19
-
20
- # List active routes
21
- playwright-cli route-list
22
-
23
- # Remove a route or all routes
24
- playwright-cli unroute "**/*.jpg"
25
- playwright-cli unroute
26
- ```
27
-
28
- ## URL Patterns
29
-
30
- ```
31
- **/api/users - Exact path match
32
- **/api/*/details - Wildcard in path
33
- **/*.{png,jpg,jpeg} - Match file extensions
34
- **/search?q=* - Match query parameters
35
- ```
36
-
37
- ## Advanced Mocking with run-code
38
-
39
- For conditional responses, request body inspection, response modification, or delays:
40
-
41
- ### Conditional Response Based on Request
42
-
43
- ```bash
44
- playwright-cli run-code "async page => {
45
- await page.route('**/api/login', route => {
46
- const body = route.request().postDataJSON();
47
- if (body.username === 'admin') {
48
- route.fulfill({ body: JSON.stringify({ token: 'mock-token' }) });
49
- } else {
50
- route.fulfill({ status: 401, body: JSON.stringify({ error: 'Invalid' }) });
51
- }
52
- });
53
- }"
54
- ```
55
-
56
- ### Modify Real Response
57
-
58
- ```bash
59
- playwright-cli run-code "async page => {
60
- await page.route('**/api/user', async route => {
61
- const response = await route.fetch();
62
- const json = await response.json();
63
- json.isPremium = true;
64
- await route.fulfill({ response, json });
65
- });
66
- }"
67
- ```
68
-
69
- ### Simulate Network Failures
70
-
71
- ```bash
72
- playwright-cli run-code "async page => {
73
- await page.route('**/api/offline', route => route.abort('internetdisconnected'));
74
- }"
75
- # Options: connectionrefused, timedout, connectionreset, internetdisconnected
76
- ```
77
-
78
- ### Delayed Response
79
-
80
- ```bash
81
- playwright-cli run-code "async page => {
82
- await page.route('**/api/slow', async route => {
83
- await new Promise(r => setTimeout(r, 3000));
84
- route.fulfill({ body: JSON.stringify({ data: 'loaded' }) });
85
- });
86
- }"
87
- ```
1
+ # Request Mocking
2
+
3
+ Intercept, mock, modify, and block network requests.
4
+
5
+ ## CLI Route Commands
6
+
7
+ ```bash
8
+ # Mock with custom status
9
+ playwright-cli route "**/*.jpg" --status=404
10
+
11
+ # Mock with JSON body
12
+ playwright-cli route "**/api/users" --body='[{"id":1,"name":"Alice"}]' --content-type=application/json
13
+
14
+ # Mock with custom headers
15
+ playwright-cli route "**/api/data" --body='{"ok":true}' --header="X-Custom: value"
16
+
17
+ # Remove headers from requests
18
+ playwright-cli route "**/*" --remove-header=cookie,authorization
19
+
20
+ # List active routes
21
+ playwright-cli route-list
22
+
23
+ # Remove a route or all routes
24
+ playwright-cli unroute "**/*.jpg"
25
+ playwright-cli unroute
26
+ ```
27
+
28
+ ## URL Patterns
29
+
30
+ ```
31
+ **/api/users - Exact path match
32
+ **/api/*/details - Wildcard in path
33
+ **/*.{png,jpg,jpeg} - Match file extensions
34
+ **/search?q=* - Match query parameters
35
+ ```
36
+
37
+ ## Advanced Mocking with run-code
38
+
39
+ For conditional responses, request body inspection, response modification, or delays:
40
+
41
+ ### Conditional Response Based on Request
42
+
43
+ ```bash
44
+ playwright-cli run-code "async page => {
45
+ await page.route('**/api/login', route => {
46
+ const body = route.request().postDataJSON();
47
+ if (body.username === 'admin') {
48
+ route.fulfill({ body: JSON.stringify({ token: 'mock-token' }) });
49
+ } else {
50
+ route.fulfill({ status: 401, body: JSON.stringify({ error: 'Invalid' }) });
51
+ }
52
+ });
53
+ }"
54
+ ```
55
+
56
+ ### Modify Real Response
57
+
58
+ ```bash
59
+ playwright-cli run-code "async page => {
60
+ await page.route('**/api/user', async route => {
61
+ const response = await route.fetch();
62
+ const json = await response.json();
63
+ json.isPremium = true;
64
+ await route.fulfill({ response, json });
65
+ });
66
+ }"
67
+ ```
68
+
69
+ ### Simulate Network Failures
70
+
71
+ ```bash
72
+ playwright-cli run-code "async page => {
73
+ await page.route('**/api/offline', route => route.abort('internetdisconnected'));
74
+ }"
75
+ # Options: connectionrefused, timedout, connectionreset, internetdisconnected
76
+ ```
77
+
78
+ ### Delayed Response
79
+
80
+ ```bash
81
+ playwright-cli run-code "async page => {
82
+ await page.route('**/api/slow', async route => {
83
+ await new Promise(r => setTimeout(r, 3000));
84
+ route.fulfill({ body: JSON.stringify({ data: 'loaded' }) });
85
+ });
86
+ }"
87
+ ```
@@ -1,241 +1,241 @@
1
- # Running Custom Playwright Code
2
-
3
- Use `run-code` to execute arbitrary Playwright code for advanced scenarios not covered by CLI commands.
4
-
5
- ## Syntax
6
-
7
- ```bash
8
- playwright-cli run-code "async page => {
9
- // Your Playwright code here
10
- // Access page.context() for browser context operations
11
- }"
12
- ```
13
-
14
- You can also load the function from a file:
15
-
16
- ```bash
17
- playwright-cli run-code --filename=./my-script.js
18
- ```
19
-
20
-
21
- The code must be a single function expression, it is wrapped in `(...)` and evaluated.
22
- import/export/require syntax is not supported.
23
-
24
- ## Geolocation
25
-
26
- ```bash
27
- # Grant geolocation permission and set location
28
- playwright-cli run-code "async page => {
29
- await page.context().grantPermissions(['geolocation']);
30
- await page.context().setGeolocation({ latitude: 37.7749, longitude: -122.4194 });
31
- }"
32
-
33
- # Set location to London
34
- playwright-cli run-code "async page => {
35
- await page.context().grantPermissions(['geolocation']);
36
- await page.context().setGeolocation({ latitude: 51.5074, longitude: -0.1278 });
37
- }"
38
-
39
- # Clear geolocation override
40
- playwright-cli run-code "async page => {
41
- await page.context().clearPermissions();
42
- }"
43
- ```
44
-
45
- ## Permissions
46
-
47
- ```bash
48
- # Grant multiple permissions
49
- playwright-cli run-code "async page => {
50
- await page.context().grantPermissions([
51
- 'geolocation',
52
- 'notifications',
53
- 'camera',
54
- 'microphone'
55
- ]);
56
- }"
57
-
58
- # Grant permissions for specific origin
59
- playwright-cli run-code "async page => {
60
- await page.context().grantPermissions(['clipboard-read'], {
61
- origin: 'https://example.com'
62
- });
63
- }"
64
- ```
65
-
66
- ## Media Emulation
67
-
68
- ```bash
69
- # Emulate dark color scheme
70
- playwright-cli run-code "async page => {
71
- await page.emulateMedia({ colorScheme: 'dark' });
72
- }"
73
-
74
- # Emulate light color scheme
75
- playwright-cli run-code "async page => {
76
- await page.emulateMedia({ colorScheme: 'light' });
77
- }"
78
-
79
- # Emulate reduced motion
80
- playwright-cli run-code "async page => {
81
- await page.emulateMedia({ reducedMotion: 'reduce' });
82
- }"
83
-
84
- # Emulate print media
85
- playwright-cli run-code "async page => {
86
- await page.emulateMedia({ media: 'print' });
87
- }"
88
- ```
89
-
90
- ## Wait Strategies
91
-
92
- ```bash
93
- # Wait for network idle
94
- playwright-cli run-code "async page => {
95
- await page.waitForLoadState('networkidle');
96
- }"
97
-
98
- # Wait for specific element
99
- playwright-cli run-code "async page => {
100
- await page.locator('.loading').waitFor({ state: 'hidden' });
101
- }"
102
-
103
- # Wait for function to return true
104
- playwright-cli run-code "async page => {
105
- await page.waitForFunction(() => window.appReady === true);
106
- }"
107
-
108
- # Wait with timeout
109
- playwright-cli run-code "async page => {
110
- await page.locator('.result').waitFor({ timeout: 10000 });
111
- }"
112
- ```
113
-
114
- ## Frames and Iframes
115
-
116
- ```bash
117
- # Work with iframe
118
- playwright-cli run-code "async page => {
119
- const frame = page.locator('iframe#my-iframe').contentFrame();
120
- await frame.locator('button').click();
121
- }"
122
-
123
- # Get all frames
124
- playwright-cli run-code "async page => {
125
- const frames = page.frames();
126
- return frames.map(f => f.url());
127
- }"
128
- ```
129
-
130
- ## File Downloads
131
-
132
- ```bash
133
- # Handle file download
134
- playwright-cli run-code "async page => {
135
- const downloadPromise = page.waitForEvent('download');
136
- await page.getByRole('link', { name: 'Download' }).click();
137
- const download = await downloadPromise;
138
- await download.saveAs('./downloaded-file.pdf');
139
- return download.suggestedFilename();
140
- }"
141
- ```
142
-
143
- ## Clipboard
144
-
145
- ```bash
146
- # Read clipboard (requires permission)
147
- playwright-cli run-code "async page => {
148
- await page.context().grantPermissions(['clipboard-read']);
149
- return await page.evaluate(() => navigator.clipboard.readText());
150
- }"
151
-
152
- # Write to clipboard
153
- playwright-cli run-code "async page => {
154
- await page.evaluate(text => navigator.clipboard.writeText(text), 'Hello clipboard!');
155
- }"
156
- ```
157
-
158
- ## Page Information
159
-
160
- ```bash
161
- # Get page title
162
- playwright-cli run-code "async page => {
163
- return await page.title();
164
- }"
165
-
166
- # Get current URL
167
- playwright-cli run-code "async page => {
168
- return page.url();
169
- }"
170
-
171
- # Get page content
172
- playwright-cli run-code "async page => {
173
- return await page.content();
174
- }"
175
-
176
- # Get viewport size
177
- playwright-cli run-code "async page => {
178
- return page.viewportSize();
179
- }"
180
- ```
181
-
182
- ## JavaScript Execution
183
-
184
- ```bash
185
- # Execute JavaScript and return result
186
- playwright-cli run-code "async page => {
187
- return await page.evaluate(() => {
188
- return {
189
- userAgent: navigator.userAgent,
190
- language: navigator.language,
191
- cookiesEnabled: navigator.cookieEnabled
192
- };
193
- });
194
- }"
195
-
196
- # Pass arguments to evaluate
197
- playwright-cli run-code "async page => {
198
- const multiplier = 5;
199
- return await page.evaluate(m => document.querySelectorAll('li').length * m, multiplier);
200
- }"
201
- ```
202
-
203
- ## Error Handling
204
-
205
- ```bash
206
- # Try-catch in run-code
207
- playwright-cli run-code "async page => {
208
- try {
209
- await page.getByRole('button', { name: 'Submit' }).click({ timeout: 1000 });
210
- return 'clicked';
211
- } catch (e) {
212
- return 'element not found';
213
- }
214
- }"
215
- ```
216
-
217
- ## Complex Workflows
218
-
219
- ```bash
220
- # Login and save state
221
- playwright-cli run-code "async page => {
222
- await page.goto('https://example.com/login');
223
- await page.getByRole('textbox', { name: 'Email' }).fill('user@example.com');
224
- await page.getByRole('textbox', { name: 'Password' }).fill('secret');
225
- await page.getByRole('button', { name: 'Sign in' }).click();
226
- await page.waitForURL('**/dashboard');
227
- await page.context().storageState({ path: 'auth.json' });
228
- return 'Login successful';
229
- }"
230
-
231
- # Scrape data from multiple pages
232
- playwright-cli run-code "async page => {
233
- const results = [];
234
- for (let i = 1; i <= 3; i++) {
235
- await page.goto(\`https://example.com/page/\${i}\`);
236
- const items = await page.locator('.item').allTextContents();
237
- results.push(...items);
238
- }
239
- return results;
240
- }"
241
- ```
1
+ # Running Custom Playwright Code
2
+
3
+ Use `run-code` to execute arbitrary Playwright code for advanced scenarios not covered by CLI commands.
4
+
5
+ ## Syntax
6
+
7
+ ```bash
8
+ playwright-cli run-code "async page => {
9
+ // Your Playwright code here
10
+ // Access page.context() for browser context operations
11
+ }"
12
+ ```
13
+
14
+ You can also load the function from a file:
15
+
16
+ ```bash
17
+ playwright-cli run-code --filename=./my-script.js
18
+ ```
19
+
20
+
21
+ The code must be a single function expression, it is wrapped in `(...)` and evaluated.
22
+ import/export/require syntax is not supported.
23
+
24
+ ## Geolocation
25
+
26
+ ```bash
27
+ # Grant geolocation permission and set location
28
+ playwright-cli run-code "async page => {
29
+ await page.context().grantPermissions(['geolocation']);
30
+ await page.context().setGeolocation({ latitude: 37.7749, longitude: -122.4194 });
31
+ }"
32
+
33
+ # Set location to London
34
+ playwright-cli run-code "async page => {
35
+ await page.context().grantPermissions(['geolocation']);
36
+ await page.context().setGeolocation({ latitude: 51.5074, longitude: -0.1278 });
37
+ }"
38
+
39
+ # Clear geolocation override
40
+ playwright-cli run-code "async page => {
41
+ await page.context().clearPermissions();
42
+ }"
43
+ ```
44
+
45
+ ## Permissions
46
+
47
+ ```bash
48
+ # Grant multiple permissions
49
+ playwright-cli run-code "async page => {
50
+ await page.context().grantPermissions([
51
+ 'geolocation',
52
+ 'notifications',
53
+ 'camera',
54
+ 'microphone'
55
+ ]);
56
+ }"
57
+
58
+ # Grant permissions for specific origin
59
+ playwright-cli run-code "async page => {
60
+ await page.context().grantPermissions(['clipboard-read'], {
61
+ origin: 'https://example.com'
62
+ });
63
+ }"
64
+ ```
65
+
66
+ ## Media Emulation
67
+
68
+ ```bash
69
+ # Emulate dark color scheme
70
+ playwright-cli run-code "async page => {
71
+ await page.emulateMedia({ colorScheme: 'dark' });
72
+ }"
73
+
74
+ # Emulate light color scheme
75
+ playwright-cli run-code "async page => {
76
+ await page.emulateMedia({ colorScheme: 'light' });
77
+ }"
78
+
79
+ # Emulate reduced motion
80
+ playwright-cli run-code "async page => {
81
+ await page.emulateMedia({ reducedMotion: 'reduce' });
82
+ }"
83
+
84
+ # Emulate print media
85
+ playwright-cli run-code "async page => {
86
+ await page.emulateMedia({ media: 'print' });
87
+ }"
88
+ ```
89
+
90
+ ## Wait Strategies
91
+
92
+ ```bash
93
+ # Wait for network idle
94
+ playwright-cli run-code "async page => {
95
+ await page.waitForLoadState('networkidle');
96
+ }"
97
+
98
+ # Wait for specific element
99
+ playwright-cli run-code "async page => {
100
+ await page.locator('.loading').waitFor({ state: 'hidden' });
101
+ }"
102
+
103
+ # Wait for function to return true
104
+ playwright-cli run-code "async page => {
105
+ await page.waitForFunction(() => window.appReady === true);
106
+ }"
107
+
108
+ # Wait with timeout
109
+ playwright-cli run-code "async page => {
110
+ await page.locator('.result').waitFor({ timeout: 10000 });
111
+ }"
112
+ ```
113
+
114
+ ## Frames and Iframes
115
+
116
+ ```bash
117
+ # Work with iframe
118
+ playwright-cli run-code "async page => {
119
+ const frame = page.locator('iframe#my-iframe').contentFrame();
120
+ await frame.locator('button').click();
121
+ }"
122
+
123
+ # Get all frames
124
+ playwright-cli run-code "async page => {
125
+ const frames = page.frames();
126
+ return frames.map(f => f.url());
127
+ }"
128
+ ```
129
+
130
+ ## File Downloads
131
+
132
+ ```bash
133
+ # Handle file download
134
+ playwright-cli run-code "async page => {
135
+ const downloadPromise = page.waitForEvent('download');
136
+ await page.getByRole('link', { name: 'Download' }).click();
137
+ const download = await downloadPromise;
138
+ await download.saveAs('./downloaded-file.pdf');
139
+ return download.suggestedFilename();
140
+ }"
141
+ ```
142
+
143
+ ## Clipboard
144
+
145
+ ```bash
146
+ # Read clipboard (requires permission)
147
+ playwright-cli run-code "async page => {
148
+ await page.context().grantPermissions(['clipboard-read']);
149
+ return await page.evaluate(() => navigator.clipboard.readText());
150
+ }"
151
+
152
+ # Write to clipboard
153
+ playwright-cli run-code "async page => {
154
+ await page.evaluate(text => navigator.clipboard.writeText(text), 'Hello clipboard!');
155
+ }"
156
+ ```
157
+
158
+ ## Page Information
159
+
160
+ ```bash
161
+ # Get page title
162
+ playwright-cli run-code "async page => {
163
+ return await page.title();
164
+ }"
165
+
166
+ # Get current URL
167
+ playwright-cli run-code "async page => {
168
+ return page.url();
169
+ }"
170
+
171
+ # Get page content
172
+ playwright-cli run-code "async page => {
173
+ return await page.content();
174
+ }"
175
+
176
+ # Get viewport size
177
+ playwright-cli run-code "async page => {
178
+ return page.viewportSize();
179
+ }"
180
+ ```
181
+
182
+ ## JavaScript Execution
183
+
184
+ ```bash
185
+ # Execute JavaScript and return result
186
+ playwright-cli run-code "async page => {
187
+ return await page.evaluate(() => {
188
+ return {
189
+ userAgent: navigator.userAgent,
190
+ language: navigator.language,
191
+ cookiesEnabled: navigator.cookieEnabled
192
+ };
193
+ });
194
+ }"
195
+
196
+ # Pass arguments to evaluate
197
+ playwright-cli run-code "async page => {
198
+ const multiplier = 5;
199
+ return await page.evaluate(m => document.querySelectorAll('li').length * m, multiplier);
200
+ }"
201
+ ```
202
+
203
+ ## Error Handling
204
+
205
+ ```bash
206
+ # Try-catch in run-code
207
+ playwright-cli run-code "async page => {
208
+ try {
209
+ await page.getByRole('button', { name: 'Submit' }).click({ timeout: 1000 });
210
+ return 'clicked';
211
+ } catch (e) {
212
+ return 'element not found';
213
+ }
214
+ }"
215
+ ```
216
+
217
+ ## Complex Workflows
218
+
219
+ ```bash
220
+ # Login and save state
221
+ playwright-cli run-code "async page => {
222
+ await page.goto('https://example.com/login');
223
+ await page.getByRole('textbox', { name: 'Email' }).fill('user@example.com');
224
+ await page.getByRole('textbox', { name: 'Password' }).fill('secret');
225
+ await page.getByRole('button', { name: 'Sign in' }).click();
226
+ await page.waitForURL('**/dashboard');
227
+ await page.context().storageState({ path: 'auth.json' });
228
+ return 'Login successful';
229
+ }"
230
+
231
+ # Scrape data from multiple pages
232
+ playwright-cli run-code "async page => {
233
+ const results = [];
234
+ for (let i = 1; i <= 3; i++) {
235
+ await page.goto(\`https://example.com/page/\${i}\`);
236
+ const items = await page.locator('.item').allTextContents();
237
+ results.push(...items);
238
+ }
239
+ return results;
240
+ }"
241
+ ```