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

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 (179) hide show
  1. package/AGENTS.md +110 -108
  2. package/CHANGELOG.md +24 -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/executors/dag-pi-executor.js +44 -0
  17. package/dist/shared/operator/capabilities.js +1 -38
  18. package/dist/shared/package-metadata.js +42 -0
  19. package/dist/sidecars/cursor-prompt/executor.js +1 -1
  20. package/dist/worker/console/chat/pi-runtime.js +25 -41
  21. package/dist/worker/console/chat/routes.js +4 -27
  22. package/dist/worker/console/operation-runner.js +0 -24
  23. package/dist/worker/console/operator-actions.js +0 -58
  24. package/dist/worker/console/static/assets/index-CvsQgALl.js +56 -0
  25. package/dist/worker/console/static/assets/{index-Dups4sSM.css → index-hJqCPs_g.css} +1 -1
  26. package/dist/worker/console/static/index.html +2 -2
  27. package/dist/worker/console/static-src/app/useRecoveryConsole.js +5 -0
  28. package/dist/worker/console/static-src/operator-chat/useChatSessions.js +2 -13
  29. package/dist/worker/console/static-src/operator-chat/useComposer.js +7 -30
  30. package/dist/worker/loop-agent/loop-agent-client.js +17 -3
  31. package/dist/worker/observability/read-model.js +20 -0
  32. package/dist/worker/observe/static/copy.js +67 -67
  33. package/dist/worker/observe/static/dag-layout.d.ts +36 -36
  34. package/dist/worker/observe/static/dom.js +220 -220
  35. package/dist/worker/observe/static/relations.js +133 -133
  36. package/dist/worker/observe/static/run-processing.js +148 -148
  37. package/dist/worker/observe/static/views/batch.js +227 -227
  38. package/dist/worker/observe/static/views/failures.js +143 -143
  39. package/dist/worker/observe/static/views/feature.js +492 -492
  40. package/dist/worker/observe/static/views/run.js +453 -453
  41. package/dist/worker/observe/static/views/shell.js +7 -7
  42. package/dist/worker/observe/static/views/timeline.js +163 -163
  43. package/dist/worker/preflight.js +2 -1
  44. package/dist/workflows/dag/backend-test-scenario-param.js +33 -23
  45. package/dist/workflows/dag/canvas-observer.js +275 -275
  46. package/dist/workflows/dag/contract-output-registry.js +14 -0
  47. package/dist/workflows/dag/contract-validator-registrations.js +8 -0
  48. package/dist/workflows/dag/dynamic-runtime/shared.js +9 -1
  49. package/dist/workflows/dag/frontend-implementation-contract.js +233 -39
  50. package/dist/workflows/dag/frontend-prewrite-gate.js +364 -61
  51. package/dist/workflows/dag/frontend-recovery-plan.js +73 -0
  52. package/dist/workflows/dag/frontend-recovery-root-manifest.js +123 -0
  53. package/dist/workflows/dag/frontend-recovery-run.js +539 -0
  54. package/dist/workflows/dag/frontend-repair.js +219 -18
  55. package/dist/workflows/dag/frontend-verification-trace.js +47 -32
  56. package/dist/workflows/dag/frontend-writer-recovery.js +106 -0
  57. package/dist/workflows/dag/frontend-writer-rollback.js +821 -0
  58. package/dist/workflows/dag/init-hybrid.js +41 -24
  59. package/dist/workflows/dag/node-execution.js +89 -0
  60. package/dist/workflows/dag/recovery-recommendation.js +58 -0
  61. package/dist/workflows/dag/runner.js +245 -11
  62. package/dist/workflows/dag/scheduler.js +257 -3
  63. package/dist/workflows/dag/types.js +130 -2
  64. package/docs/architecture/evolution.md +73 -73
  65. package/docs/architecture/system-overview.md +100 -100
  66. package/docs/architecture/worker-and-feature.md +122 -122
  67. package/docs/skills/README.md +7 -7
  68. package/docs/templates/adr.md +60 -60
  69. package/docs/templates/agent-dag-authority-surface-audit.prompt.md +94 -94
  70. package/docs/templates/agent-dag-decision-envelope.schema.json +213 -213
  71. package/docs/templates/agent-dag-decision-gate.prompt.md +246 -246
  72. package/docs/templates/agent-dag-process-supervisor.prompt.md +98 -98
  73. package/docs/templates/agent-dag-report.schema.json +473 -473
  74. package/docs/templates/agent-dag-review-verdict.prompt.md +68 -68
  75. package/docs/templates/backend-test-result.schema.json +99 -99
  76. package/docs/templates/evaluation/agents-map-slim-v1.md +87 -87
  77. package/docs/templates/evaluation/agents-map-verbose-v0.md +153 -153
  78. package/docs/templates/feature-spec.md +53 -53
  79. package/docs/templates/frontend-design-contract.md +42 -42
  80. package/docs/templates/frontend-eval/fixtures/failures/01-type-build-error.md +17 -17
  81. package/docs/templates/frontend-eval/fixtures/failures/02-unit-component-test-fail.md +16 -16
  82. package/docs/templates/frontend-eval/fixtures/failures/03-fixture-schema-drift.md +16 -16
  83. package/docs/templates/frontend-eval/fixtures/failures/04-missing-loading-empty-error-state.md +16 -16
  84. package/docs/templates/frontend-eval/fixtures/failures/05-forbidden-write-writeset-expansion.md +16 -16
  85. package/docs/templates/frontend-eval/fixtures/failures/06-unapproved-dependency-add.md +16 -16
  86. package/docs/templates/frontend-eval/fixtures/failures/07-mock-production-on.md +21 -21
  87. package/docs/templates/frontend-eval/fixtures/functional/01-simple-component-style.md +29 -29
  88. package/docs/templates/frontend-eval/fixtures/functional/02-form-validation.md +28 -28
  89. package/docs/templates/frontend-eval/fixtures/functional/03-list-detail-page.md +28 -28
  90. package/docs/templates/frontend-eval/fixtures/functional/04-api-mock.md +29 -29
  91. package/docs/templates/frontend-eval/fixtures/functional/05-permission-auth-gated-ui.md +27 -27
  92. package/docs/templates/frontend-eval/fixtures/functional/06-ssr-server-client-boundary.md +28 -28
  93. package/docs/templates/frontend-eval/fixtures/functional/07-shared-public-component-api.md +28 -28
  94. package/docs/templates/frontend-eval/fixtures/functional/08-pure-local-no-remote.md +27 -27
  95. package/docs/templates/frontend-eval/metrics.md +138 -138
  96. package/docs/templates/frontend-eval/smoke-targets.md +53 -53
  97. package/docs/templates/frontend-task-constraints.md +35 -35
  98. package/docs/templates/frontend-task-requirement.md +70 -70
  99. package/docs/templates/init-evolution-review.md +35 -35
  100. package/docs/templates/init-managed-agents.md +154 -156
  101. package/docs/templates/interactive-ui-round2-experiment.md +66 -66
  102. package/docs/templates/knowledge-graph-bootstrap-dag.json +118 -118
  103. package/docs/templates/knowledge-sync-dag.json +178 -178
  104. package/docs/templates/knowledge-sync-draft.schema.json +71 -71
  105. package/docs/templates/product-line/closeout.yaml +9 -9
  106. package/docs/templates/product-line/design.md +13 -13
  107. package/docs/templates/product-line/links.md +10 -10
  108. package/docs/templates/product-line/requirement.md +17 -17
  109. package/docs/templates/product-line/test-plan.md +7 -7
  110. package/docs/templates/project-start-checklist.md +9 -9
  111. package/docs/templates/qa-report.md +48 -48
  112. package/docs/templates/sprint-contract.md +29 -29
  113. package/docs/templates/worker-dogfood-evidence.md +80 -80
  114. package/docs/templates/worker-dogfood-setup.md +68 -68
  115. package/harness.json +2 -5
  116. package/package.json +2 -2
  117. package/scripts/kb-bootstrap-init-skeleton.sh +0 -0
  118. package/scripts/kb-graph-incremental-prepare.mjs +0 -0
  119. package/scripts/kb-graph-materialize.mjs +105 -105
  120. package/scripts/kb-graph-promote.mjs +164 -164
  121. package/scripts/kb-query.mjs +554 -554
  122. package/skills/agent-worker/SKILL.md +48 -48
  123. package/skills/agent-worker/references/agent-worker-operator.md +159 -159
  124. package/skills/ai-engineering-context/SKILL.md +48 -48
  125. package/skills/analyze-product-dependencies/scripts/test-validators.mjs +0 -0
  126. package/skills/analyze-product-dependencies/scripts/validate-api-documentation.mjs +0 -0
  127. package/skills/analyze-product-dependencies/scripts/validate-dependency-analysis.mjs +0 -0
  128. package/skills/analyze-product-dependencies/scripts/validate-product-requirement-input.mjs +0 -0
  129. package/skills/analyze-product-requirements/scripts/compute-source-identity.mjs +0 -0
  130. package/skills/analyze-product-requirements/scripts/test-validators.mjs +0 -0
  131. package/skills/analyze-product-requirements/scripts/validate-product-analysis.mjs +0 -0
  132. package/skills/analyze-product-requirements/scripts/validate-product-requirement.mjs +0 -0
  133. package/skills/analyze-product-requirements/scripts/validate-requirement-clarification.mjs +0 -0
  134. package/skills/browser-tools/browser-content.js +103 -103
  135. package/skills/browser-tools/browser-cookies.js +35 -35
  136. package/skills/browser-tools/browser-eval.js +53 -53
  137. package/skills/browser-tools/browser-hn-scraper.js +108 -108
  138. package/skills/browser-tools/browser-nav.js +44 -44
  139. package/skills/browser-tools/browser-pick.js +162 -162
  140. package/skills/browser-tools/browser-screenshot.js +34 -34
  141. package/skills/browser-tools/browser-start.js +86 -86
  142. package/skills/browser-tools/package-lock.json +2556 -2556
  143. package/skills/browser-tools/package.json +19 -19
  144. package/skills/code-review-core/SKILL.md +20 -20
  145. package/skills/codebase-scout/SKILL.md +19 -19
  146. package/skills/grill-me/SKILL.md +10 -10
  147. package/skills/local-jacoco-coverage/scripts/run-coverage-analysis.sh +0 -0
  148. package/skills/local-jacoco-coverage/scripts/start-jacoco-agent.sh +0 -0
  149. package/skills/loop-agent/SKILL.md +0 -1
  150. package/skills/loop-agent/references/command-reference.md +639 -641
  151. package/skills/loop-agent/references/docs-converge.md +126 -126
  152. package/skills/loop-agent/references/learned/README.md +21 -21
  153. package/skills/loop-agent/references/pi-prompt.md +23 -23
  154. package/skills/loop-agent/references/pi-subagent-assisted-mode.md +84 -84
  155. package/skills/playwright-cli/references/element-attributes.md +23 -23
  156. package/skills/playwright-cli/references/playwright-tests.md +39 -39
  157. package/skills/playwright-cli/references/request-mocking.md +87 -87
  158. package/skills/playwright-cli/references/running-code.md +241 -241
  159. package/skills/playwright-cli/references/session-management.md +225 -225
  160. package/skills/playwright-cli/references/storage-state.md +275 -275
  161. package/skills/playwright-cli/references/test-generation.md +433 -433
  162. package/skills/requesting-code-review/SKILL.md +101 -101
  163. package/skills/requesting-code-review/code-reviewer.md +168 -168
  164. package/skills/systematic-debugging/CREATION-LOG.md +119 -119
  165. package/skills/systematic-debugging/condition-based-waiting-example.ts +158 -158
  166. package/skills/systematic-debugging/condition-based-waiting.md +115 -115
  167. package/skills/systematic-debugging/defense-in-depth.md +122 -122
  168. package/skills/systematic-debugging/find-polluter.sh +63 -63
  169. package/skills/systematic-debugging/root-cause-tracing.md +169 -169
  170. package/skills/systematic-debugging/test-academic.md +14 -14
  171. package/skills/systematic-debugging/test-pressure-1.md +58 -58
  172. package/skills/systematic-debugging/test-pressure-2.md +68 -68
  173. package/skills/systematic-debugging/test-pressure-3.md +69 -69
  174. package/skills/using-git-worktrees/SKILL.md +215 -215
  175. package/skills/verification-before-completion/SKILL.md +154 -154
  176. package/skills/webapp-testing/SKILL.md +19 -19
  177. package/dist/worker/console/operation-wait.js +0 -241
  178. package/dist/worker/console/static/assets/index-SjjjZnV3.js +0 -56
  179. 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
+ ```