@bctrl/sdk 1.0.1 → 1.0.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 (279) hide show
  1. package/README.md +24 -29
  2. package/dist/bctrl.d.ts +22 -36
  3. package/dist/bctrl.js +40 -75
  4. package/dist/browsers.d.ts +24 -0
  5. package/dist/browsers.js +82 -0
  6. package/dist/errors.d.ts +49 -43
  7. package/dist/errors.js +83 -120
  8. package/dist/files.d.ts +31 -0
  9. package/dist/files.js +97 -0
  10. package/dist/http.d.ts +18 -0
  11. package/dist/http.js +135 -0
  12. package/dist/index.d.ts +9 -12
  13. package/dist/index.js +8 -23
  14. package/dist/invocations.d.ts +24 -0
  15. package/dist/invocations.js +66 -0
  16. package/dist/pagination.d.ts +2 -0
  17. package/dist/pagination.js +13 -0
  18. package/dist/runs.d.ts +38 -0
  19. package/dist/runs.js +99 -0
  20. package/dist/runtimes.d.ts +73 -0
  21. package/dist/runtimes.js +205 -0
  22. package/dist/spaces.d.ts +41 -0
  23. package/dist/spaces.js +96 -0
  24. package/dist/types.d.ts +386 -0
  25. package/dist/types.js +1 -0
  26. package/dist/utils.d.ts +4 -0
  27. package/dist/utils.js +27 -0
  28. package/dist/version.js +2 -2
  29. package/package.json +12 -31
  30. package/dist/agents/browser-use/index.d.ts +0 -1
  31. package/dist/agents/browser-use/index.js +0 -9
  32. package/dist/agents/browser-use/namespace.d.ts +0 -39
  33. package/dist/agents/browser-use/namespace.js +0 -93
  34. package/dist/agents/index.d.ts +0 -2
  35. package/dist/agents/index.js +0 -17
  36. package/dist/agents/stagehand/core.d.ts +0 -93
  37. package/dist/agents/stagehand/core.js +0 -144
  38. package/dist/agents/stagehand/index.d.ts +0 -3
  39. package/dist/agents/stagehand/index.js +0 -24
  40. package/dist/agents/stagehand/namespace.d.ts +0 -51
  41. package/dist/agents/stagehand/namespace.js +0 -65
  42. package/dist/ai-credentials/client.d.ts +0 -12
  43. package/dist/ai-credentials/client.js +0 -70
  44. package/dist/ai-credentials/index.d.ts +0 -1
  45. package/dist/ai-credentials/index.js +0 -1
  46. package/dist/base/event-binding.d.ts +0 -7
  47. package/dist/base/event-binding.js +0 -23
  48. package/dist/base/types.d.ts +0 -109
  49. package/dist/base/types.js +0 -4
  50. package/dist/browser-extensions/client.d.ts +0 -15
  51. package/dist/browser-extensions/client.js +0 -72
  52. package/dist/browser-extensions/index.d.ts +0 -2
  53. package/dist/browser-extensions/index.js +0 -1
  54. package/dist/browser-profiles/client.d.ts +0 -11
  55. package/dist/browser-profiles/client.js +0 -63
  56. package/dist/browser-profiles/index.d.ts +0 -1
  57. package/dist/browser-profiles/index.js +0 -1
  58. package/dist/captcha/index.d.ts +0 -1
  59. package/dist/captcha/index.js +0 -1
  60. package/dist/captcha/namespace.d.ts +0 -34
  61. package/dist/captcha/namespace.js +0 -41
  62. package/dist/client/index.d.ts +0 -1
  63. package/dist/client/index.js +0 -1
  64. package/dist/client/rpc.d.ts +0 -83
  65. package/dist/client/rpc.js +0 -354
  66. package/dist/config.d.ts +0 -5
  67. package/dist/config.js +0 -28
  68. package/dist/constants/browser.d.ts +0 -2
  69. package/dist/constants/browser.js +0 -1
  70. package/dist/contracts/agent-tools.d.ts +0 -45
  71. package/dist/contracts/agent-tools.js +0 -31
  72. package/dist/contracts/automation.d.ts +0 -265
  73. package/dist/contracts/automation.js +0 -109
  74. package/dist/contracts/browser-management.d.ts +0 -179
  75. package/dist/contracts/browser-management.js +0 -95
  76. package/dist/contracts/browser-use.d.ts +0 -136
  77. package/dist/contracts/browser-use.js +0 -93
  78. package/dist/contracts/captcha.d.ts +0 -114
  79. package/dist/contracts/captcha.js +0 -40
  80. package/dist/contracts/desktop.d.ts +0 -223
  81. package/dist/contracts/desktop.js +0 -121
  82. package/dist/contracts/drivers/playwright.d.ts +0 -2008
  83. package/dist/contracts/drivers/playwright.js +0 -2033
  84. package/dist/contracts/drivers/puppeteer.d.ts +0 -1221
  85. package/dist/contracts/drivers/puppeteer.js +0 -941
  86. package/dist/contracts/drivers/selenium.d.ts +0 -156
  87. package/dist/contracts/drivers/selenium.js +0 -61
  88. package/dist/contracts/drivers/stagehand.d.ts +0 -155
  89. package/dist/contracts/drivers/stagehand.js +0 -7
  90. package/dist/contracts/extensions.d.ts +0 -13
  91. package/dist/contracts/extensions.js +0 -9
  92. package/dist/contracts/index.d.ts +0 -13
  93. package/dist/contracts/index.js +0 -13
  94. package/dist/contracts/public-api.d.ts +0 -360
  95. package/dist/contracts/public-api.js +0 -17
  96. package/dist/contracts/runtime.d.ts +0 -81
  97. package/dist/contracts/runtime.js +0 -16
  98. package/dist/contracts/stagehand.d.ts +0 -253
  99. package/dist/contracts/stagehand.js +0 -145
  100. package/dist/contracts/storage.d.ts +0 -51
  101. package/dist/contracts/storage.js +0 -56
  102. package/dist/contracts/vault.d.ts +0 -119
  103. package/dist/contracts/vault.js +0 -112
  104. package/dist/contracts/version.d.ts +0 -3
  105. package/dist/contracts/version.js +0 -16
  106. package/dist/desktop.d.ts +0 -2
  107. package/dist/desktop.js +0 -3
  108. package/dist/drivers/desktop/index.d.ts +0 -65
  109. package/dist/drivers/desktop/index.js +0 -68
  110. package/dist/drivers/desktop/session.d.ts +0 -313
  111. package/dist/drivers/desktop/session.js +0 -432
  112. package/dist/drivers/playwright/event-emitter.d.ts +0 -160
  113. package/dist/drivers/playwright/event-emitter.js +0 -297
  114. package/dist/drivers/playwright/generated/api-request-context.d.ts +0 -137
  115. package/dist/drivers/playwright/generated/api-request-context.js +0 -154
  116. package/dist/drivers/playwright/generated/api-response.d.ts +0 -119
  117. package/dist/drivers/playwright/generated/api-response.js +0 -123
  118. package/dist/drivers/playwright/generated/browser-context.d.ts +0 -284
  119. package/dist/drivers/playwright/generated/browser-context.js +0 -458
  120. package/dist/drivers/playwright/generated/browser.d.ts +0 -120
  121. package/dist/drivers/playwright/generated/browser.js +0 -151
  122. package/dist/drivers/playwright/generated/clock.d.ts +0 -80
  123. package/dist/drivers/playwright/generated/clock.js +0 -94
  124. package/dist/drivers/playwright/generated/console-message.d.ts +0 -94
  125. package/dist/drivers/playwright/generated/console-message.js +0 -89
  126. package/dist/drivers/playwright/generated/coverage.d.ts +0 -57
  127. package/dist/drivers/playwright/generated/coverage.js +0 -66
  128. package/dist/drivers/playwright/generated/dialog.d.ts +0 -79
  129. package/dist/drivers/playwright/generated/dialog.js +0 -80
  130. package/dist/drivers/playwright/generated/element-handle.d.ts +0 -399
  131. package/dist/drivers/playwright/generated/element-handle.js +0 -501
  132. package/dist/drivers/playwright/generated/frame-locator.d.ts +0 -34
  133. package/dist/drivers/playwright/generated/frame-locator.js +0 -63
  134. package/dist/drivers/playwright/generated/frame.d.ts +0 -557
  135. package/dist/drivers/playwright/generated/frame.js +0 -634
  136. package/dist/drivers/playwright/generated/js-handle.d.ts +0 -72
  137. package/dist/drivers/playwright/generated/js-handle.js +0 -92
  138. package/dist/drivers/playwright/generated/keyboard.d.ts +0 -103
  139. package/dist/drivers/playwright/generated/keyboard.js +0 -113
  140. package/dist/drivers/playwright/generated/locator.d.ts +0 -795
  141. package/dist/drivers/playwright/generated/locator.js +0 -974
  142. package/dist/drivers/playwright/generated/mouse.d.ts +0 -97
  143. package/dist/drivers/playwright/generated/mouse.js +0 -109
  144. package/dist/drivers/playwright/generated/page.d.ts +0 -762
  145. package/dist/drivers/playwright/generated/page.js +0 -988
  146. package/dist/drivers/playwright/generated/touchscreen.d.ts +0 -34
  147. package/dist/drivers/playwright/generated/touchscreen.js +0 -37
  148. package/dist/drivers/playwright/generated/tracing.d.ts +0 -78
  149. package/dist/drivers/playwright/generated/tracing.js +0 -80
  150. package/dist/drivers/playwright/generated/worker.d.ts +0 -53
  151. package/dist/drivers/playwright/generated/worker.js +0 -59
  152. package/dist/drivers/playwright/index.d.ts +0 -19
  153. package/dist/drivers/playwright/index.js +0 -20
  154. package/dist/drivers/playwright/remote-base.d.ts +0 -62
  155. package/dist/drivers/playwright/remote-base.js +0 -86
  156. package/dist/drivers/playwright/types.d.ts +0 -148
  157. package/dist/drivers/playwright/types.js +0 -8
  158. package/dist/drivers/puppeteer/errors.d.ts +0 -50
  159. package/dist/drivers/puppeteer/errors.js +0 -71
  160. package/dist/drivers/puppeteer/event-emitter.d.ts +0 -145
  161. package/dist/drivers/puppeteer/event-emitter.js +0 -259
  162. package/dist/drivers/puppeteer/generated/accessibility.d.ts +0 -77
  163. package/dist/drivers/puppeteer/generated/accessibility.js +0 -74
  164. package/dist/drivers/puppeteer/generated/browser-context.d.ts +0 -116
  165. package/dist/drivers/puppeteer/generated/browser-context.js +0 -168
  166. package/dist/drivers/puppeteer/generated/browser.d.ts +0 -169
  167. package/dist/drivers/puppeteer/generated/browser.js +0 -246
  168. package/dist/drivers/puppeteer/generated/console-message.d.ts +0 -54
  169. package/dist/drivers/puppeteer/generated/console-message.js +0 -69
  170. package/dist/drivers/puppeteer/generated/coverage.d.ts +0 -49
  171. package/dist/drivers/puppeteer/generated/coverage.js +0 -57
  172. package/dist/drivers/puppeteer/generated/dialog.d.ts +0 -46
  173. package/dist/drivers/puppeteer/generated/dialog.js +0 -60
  174. package/dist/drivers/puppeteer/generated/element-handle.d.ts +0 -261
  175. package/dist/drivers/puppeteer/generated/element-handle.js +0 -341
  176. package/dist/drivers/puppeteer/generated/file-chooser.d.ts +0 -34
  177. package/dist/drivers/puppeteer/generated/file-chooser.js +0 -43
  178. package/dist/drivers/puppeteer/generated/frame.d.ts +0 -221
  179. package/dist/drivers/puppeteer/generated/frame.js +0 -302
  180. package/dist/drivers/puppeteer/generated/http-request.d.ts +0 -195
  181. package/dist/drivers/puppeteer/generated/http-request.js +0 -243
  182. package/dist/drivers/puppeteer/generated/http-response.d.ts +0 -142
  183. package/dist/drivers/puppeteer/generated/http-response.js +0 -169
  184. package/dist/drivers/puppeteer/generated/js-handle.d.ts +0 -104
  185. package/dist/drivers/puppeteer/generated/js-handle.js +0 -125
  186. package/dist/drivers/puppeteer/generated/keyboard.d.ts +0 -79
  187. package/dist/drivers/puppeteer/generated/keyboard.js +0 -89
  188. package/dist/drivers/puppeteer/generated/locator.d.ts +0 -141
  189. package/dist/drivers/puppeteer/generated/locator.js +0 -164
  190. package/dist/drivers/puppeteer/generated/mouse.d.ts +0 -74
  191. package/dist/drivers/puppeteer/generated/mouse.js +0 -94
  192. package/dist/drivers/puppeteer/generated/page.d.ts +0 -604
  193. package/dist/drivers/puppeteer/generated/page.js +0 -776
  194. package/dist/drivers/puppeteer/generated/target.d.ts +0 -105
  195. package/dist/drivers/puppeteer/generated/target.js +0 -123
  196. package/dist/drivers/puppeteer/generated/touchscreen.d.ts +0 -87
  197. package/dist/drivers/puppeteer/generated/touchscreen.js +0 -103
  198. package/dist/drivers/puppeteer/generated/tracing.d.ts +0 -38
  199. package/dist/drivers/puppeteer/generated/tracing.js +0 -43
  200. package/dist/drivers/puppeteer/generated/web-worker.d.ts +0 -63
  201. package/dist/drivers/puppeteer/generated/web-worker.js +0 -73
  202. package/dist/drivers/puppeteer/index.d.ts +0 -21
  203. package/dist/drivers/puppeteer/index.js +0 -23
  204. package/dist/drivers/puppeteer/remote-base.d.ts +0 -57
  205. package/dist/drivers/puppeteer/remote-base.js +0 -79
  206. package/dist/drivers/puppeteer/types.d.ts +0 -178
  207. package/dist/drivers/puppeteer/types.js +0 -8
  208. package/dist/drivers/selenium/driver.d.ts +0 -28
  209. package/dist/drivers/selenium/driver.js +0 -169
  210. package/dist/drivers/selenium/element.d.ts +0 -34
  211. package/dist/drivers/selenium/element.js +0 -73
  212. package/dist/drivers/selenium/index.d.ts +0 -3
  213. package/dist/drivers/selenium/index.js +0 -5
  214. package/dist/drivers/selenium/types.d.ts +0 -2
  215. package/dist/drivers/selenium/types.js +0 -12
  216. package/dist/drivers/stagehand/generated/context.d.ts +0 -127
  217. package/dist/drivers/stagehand/generated/context.js +0 -153
  218. package/dist/drivers/stagehand/generated/locator.d.ts +0 -324
  219. package/dist/drivers/stagehand/generated/locator.js +0 -368
  220. package/dist/drivers/stagehand/generated/page.d.ts +0 -377
  221. package/dist/drivers/stagehand/generated/page.js +0 -439
  222. package/dist/drivers/stagehand/generated/response.d.ts +0 -197
  223. package/dist/drivers/stagehand/generated/response.js +0 -232
  224. package/dist/drivers/stagehand/index.d.ts +0 -5
  225. package/dist/drivers/stagehand/index.js +0 -8
  226. package/dist/drivers/stagehand/types.d.ts +0 -1
  227. package/dist/drivers/stagehand/types.js +0 -7
  228. package/dist/extensions/client.d.ts +0 -47
  229. package/dist/extensions/client.js +0 -154
  230. package/dist/extensions/index.d.ts +0 -1
  231. package/dist/extensions/index.js +0 -1
  232. package/dist/internal/dev-client.d.ts +0 -5
  233. package/dist/internal/dev-client.js +0 -9
  234. package/dist/internal/rpc-targets.d.ts +0 -17
  235. package/dist/internal/rpc-targets.js +0 -58
  236. package/dist/internal/serialization.d.ts +0 -32
  237. package/dist/internal/serialization.js +0 -42
  238. package/dist/internal/transport.d.ts +0 -24
  239. package/dist/internal/transport.js +0 -29
  240. package/dist/playwright.d.ts +0 -1
  241. package/dist/playwright.js +0 -2
  242. package/dist/puppeteer.d.ts +0 -1
  243. package/dist/puppeteer.js +0 -2
  244. package/dist/selenium.d.ts +0 -1
  245. package/dist/selenium.js +0 -2
  246. package/dist/stagehand.d.ts +0 -1
  247. package/dist/stagehand.js +0 -2
  248. package/dist/storage/client.d.ts +0 -151
  249. package/dist/storage/client.js +0 -329
  250. package/dist/storage/index.d.ts +0 -2
  251. package/dist/storage/index.js +0 -4
  252. package/dist/telemetry.d.ts +0 -18
  253. package/dist/telemetry.js +0 -93
  254. package/dist/updates/client.d.ts +0 -8
  255. package/dist/updates/client.js +0 -128
  256. package/dist/updates/index.d.ts +0 -1
  257. package/dist/updates/index.js +0 -1
  258. package/dist/utils/http.d.ts +0 -39
  259. package/dist/utils/http.js +0 -88
  260. package/dist/utils/index.d.ts +0 -4
  261. package/dist/utils/index.js +0 -4
  262. package/dist/utils/logger.d.ts +0 -27
  263. package/dist/utils/logger.js +0 -74
  264. package/dist/utils/schema.d.ts +0 -17
  265. package/dist/utils/schema.js +0 -31
  266. package/dist/utils/url.d.ts +0 -5
  267. package/dist/utils/url.js +0 -7
  268. package/dist/vault/client.d.ts +0 -43
  269. package/dist/vault/client.js +0 -123
  270. package/dist/vault/index.d.ts +0 -1
  271. package/dist/vault/index.js +0 -1
  272. package/dist/workspaces/browser-runtime.d.ts +0 -251
  273. package/dist/workspaces/browser-runtime.js +0 -1025
  274. package/dist/workspaces/client.d.ts +0 -48
  275. package/dist/workspaces/client.js +0 -222
  276. package/dist/workspaces/index.d.ts +0 -2
  277. package/dist/workspaces/index.js +0 -2
  278. package/dist/workspaces/runtime-event-pump.d.ts +0 -65
  279. package/dist/workspaces/runtime-event-pump.js +0 -716
@@ -1,261 +0,0 @@
1
- /**
2
- * AUTO-GENERATED FILE - DO NOT EDIT
3
- *
4
- * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
5
- * Run `pnpm generate:puppeteer` to regenerate.
6
- */
7
- import type { SimpleRpcSender } from '../../../internal/transport.js';
8
- import { RemoteBase } from '../remote-base.js';
9
- import type { PuppeteerAutofillData, PuppeteerBoundingBox, PuppeteerBoxModel, PuppeteerClickOptions, PuppeteerDragData, PuppeteerKeyPressOptions, PuppeteerKeyboardTypeOptions, PuppeteerOffset, PuppeteerPoint, PuppeteerWaitForSelectorOptions, TouchHandle } from '../types.js';
10
- import type { RemotePuppeteerFrame } from './frame.js';
11
- import type { RemotePuppeteerLocator } from './locator.js';
12
- /**
13
- * RemotePuppeteerElementHandle - Remote Puppeteer ElementHandle API over RPC.
14
- *
15
- * @see https://pptr.dev/api/puppeteer.elementhandle
16
- */
17
- export declare class RemotePuppeteerElementHandle extends RemoteBase {
18
- /** The handle ID (alias for id, for compatibility). */
19
- handleId: string;
20
- private createElementHandle;
21
- private createFrame;
22
- private createLocator;
23
- private createTouchHandle;
24
- constructor(id: string, sendRpc: SimpleRpcSender, createElementHandle: (handleId: string) => RemotePuppeteerElementHandle, createFrame: (frameId: string) => RemotePuppeteerFrame, createLocator: (handleId: string) => RemotePuppeteerLocator, createTouchHandle: (touchId: string) => TouchHandle);
25
- /**
26
- * Click the element.
27
- *
28
- * @see https://pptr.dev/api/puppeteer.elementhandle.click
29
- */
30
- click(options?: PuppeteerClickOptions): Promise<void>;
31
- /**
32
- * Hover over the element.
33
- *
34
- * @see https://pptr.dev/api/puppeteer.elementhandle.hover
35
- */
36
- hover(): Promise<void>;
37
- /**
38
- * Tap the element (for touch devices).
39
- *
40
- * @see https://pptr.dev/api/puppeteer.elementhandle.tap
41
- */
42
- tap(): Promise<void>;
43
- /**
44
- * Focus the element.
45
- *
46
- * @see https://pptr.dev/api/puppeteer.elementhandle.focus
47
- */
48
- focus(): Promise<void>;
49
- /**
50
- * Type text into the element.
51
- *
52
- * @see https://pptr.dev/api/puppeteer.elementhandle.type
53
- */
54
- type(text: string, options?: PuppeteerKeyboardTypeOptions): Promise<void>;
55
- /**
56
- * Press a key while focused on the element.
57
- *
58
- * @see https://pptr.dev/api/puppeteer.elementhandle.press
59
- */
60
- press(key: string, options?: PuppeteerKeyPressOptions): Promise<void>;
61
- /**
62
- * Select options in a <select> element.
63
- * @returns An array of selected option values.
64
- *
65
- * @see https://pptr.dev/api/puppeteer.elementhandle.select
66
- */
67
- select(...values: string[]): Promise<string[]>;
68
- /**
69
- * Upload files to a file input element.
70
- *
71
- * @see https://pptr.dev/api/puppeteer.elementhandle.uploadfile
72
- */
73
- uploadFile(...filePaths: string[]): Promise<void>;
74
- /**
75
- * Scroll the element into view.
76
- *
77
- * @see https://pptr.dev/api/puppeteer.elementhandle.scrollintoview
78
- */
79
- scrollIntoView(): Promise<void>;
80
- /**
81
- * Test if the form is compatible with browser autofill. Currently supports credit card autofill in Chrome headless/headful only.
82
- *
83
- * @see https://pptr.dev/api/puppeteer.elementhandle.autofill
84
- */
85
- autofill(data: PuppeteerAutofillData): Promise<void>;
86
- /**
87
- * Query for a child element.
88
- * @returns The matching element or null if not found.
89
- *
90
- * @see https://pptr.dev/api/puppeteer.elementhandle._
91
- */
92
- $(selector: string): Promise<RemotePuppeteerElementHandle | null>;
93
- /**
94
- * Query for all matching child elements.
95
- * @returns An array of matching elements.
96
- *
97
- * @see https://pptr.dev/api/puppeteer.elementhandle.__
98
- */
99
- $$(selector: string): Promise<RemotePuppeteerElementHandle[]>;
100
- /**
101
- * Get a property value.
102
- *
103
- * @see https://pptr.dev/api/puppeteer.elementhandle.getproperty
104
- */
105
- getProperty<T = unknown>(propertyName: string): Promise<T>;
106
- /**
107
- * Get the JSON value of the element.
108
- *
109
- * @see https://pptr.dev/api/puppeteer.jshandle.jsonvalue
110
- */
111
- jsonValue<T = unknown>(): Promise<T>;
112
- /**
113
- * Check if the element is visible.
114
- *
115
- * @see https://pptr.dev/api/puppeteer.elementhandle.isvisible
116
- */
117
- isVisible(): Promise<boolean>;
118
- /**
119
- * Check if the element is hidden.
120
- *
121
- * @see https://pptr.dev/api/puppeteer.elementhandle.ishidden
122
- */
123
- isHidden(): Promise<boolean>;
124
- /**
125
- * Check if the element intersects the viewport.
126
- *
127
- * @see https://pptr.dev/api/puppeteer.elementhandle.isintersectingviewport
128
- */
129
- isIntersectingViewport(options?: {
130
- threshold?: number;
131
- }): Promise<boolean>;
132
- /**
133
- * Get the bounding box of the element.
134
- * @returns The bounding box or null if the element is not visible.
135
- *
136
- * @see https://pptr.dev/api/puppeteer.elementhandle.boundingbox
137
- */
138
- boundingBox(): Promise<PuppeteerBoundingBox | null>;
139
- /**
140
- * Get the CSS box model of the element.
141
- * @returns The box model or null if the element is not visible.
142
- *
143
- * @see https://pptr.dev/api/puppeteer.elementhandle.boxmodel
144
- */
145
- boxModel(): Promise<PuppeteerBoxModel | null>;
146
- /**
147
- * Get a clickable point within the element.
148
- *
149
- * @see https://pptr.dev/api/puppeteer.elementhandle.clickablepoint
150
- */
151
- clickablePoint(offset?: PuppeteerOffset): Promise<PuppeteerPoint>;
152
- /**
153
- * Evaluate a function in the context of the element.
154
- *
155
- * @remarks
156
- * The element is passed as the first argument to the function.
157
- *
158
- * @see https://pptr.dev/api/puppeteer.elementhandle.evaluate
159
- */
160
- evaluate<T = unknown>(pageFunction: string | ((element: Element, ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
161
- /**
162
- * Evaluate a function on the first child matching the selector.
163
- *
164
- * @see https://pptr.dev/api/puppeteer.elementhandle._eval
165
- */
166
- $eval<T = unknown>(selector: string, pageFunction: string | ((element: Element, ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
167
- /**
168
- * Evaluate a function on all children matching the selector.
169
- *
170
- * @see https://pptr.dev/api/puppeteer.elementhandle.__eval
171
- */
172
- $$eval<T = unknown>(selector: string, pageFunction: string | ((elements: Element[], ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
173
- /**
174
- * Get the content frame for iframe elements.
175
- * @returns The frame or null if not an iframe.
176
- *
177
- * @see https://pptr.dev/api/puppeteer.elementhandle.contentframe
178
- */
179
- contentFrame(): Promise<RemotePuppeteerFrame | null>;
180
- /**
181
- * Drag the element to the given target.
182
- * @param target - Target point or element to drag to.
183
- *
184
- * @see https://pptr.dev/api/puppeteer.elementhandle.drag
185
- */
186
- drag(target: PuppeteerPoint | RemotePuppeteerElementHandle): Promise<PuppeteerDragData | void>;
187
- /**
188
- * Dispatch a dragenter event.
189
- *
190
- * @remarks
191
- * Deprecated: dragenter is automatically performed during dragging.
192
- *
193
- * @see https://pptr.dev/api/puppeteer.elementhandle.dragenter
194
- */
195
- dragEnter(data?: PuppeteerDragData): Promise<void>;
196
- /**
197
- * Dispatch a dragover event.
198
- *
199
- * @remarks
200
- * Deprecated: dragover is automatically performed during dragging.
201
- *
202
- * @see https://pptr.dev/api/puppeteer.elementhandle.dragover
203
- */
204
- dragOver(data?: PuppeteerDragData): Promise<void>;
205
- /**
206
- * Drag and drop to another element or point.
207
- * @param target - Target element or point to drop onto.
208
- *
209
- * @see https://pptr.dev/api/puppeteer.elementhandle.draganddrop
210
- */
211
- dragAndDrop(target: RemotePuppeteerElementHandle | PuppeteerPoint, options?: {
212
- delay?: number;
213
- }): Promise<void>;
214
- /**
215
- * Drop the given element onto the current one.
216
- * @param element - Element to drop.
217
- *
218
- * @see https://pptr.dev/api/puppeteer.elementhandle.drop
219
- */
220
- drop(element: RemotePuppeteerElementHandle): Promise<void>;
221
- /**
222
- * Move the touch to the center of the element.
223
- *
224
- * @remarks
225
- * Scrolls element into view if needed.
226
- *
227
- * @see https://pptr.dev/api/puppeteer.elementhandle.touchmove
228
- */
229
- touchMove(touch?: {
230
- touchId?: string;
231
- }): Promise<void>;
232
- /**
233
- * End the first active touch.
234
- *
235
- * @see https://pptr.dev/api/puppeteer.elementhandle.touchend
236
- */
237
- touchEnd(): Promise<void>;
238
- /**
239
- * Wait for a child element to appear.
240
- *
241
- * @see https://pptr.dev/api/puppeteer.elementhandle.waitforselector
242
- */
243
- waitForSelector(selector: string, options?: PuppeteerWaitForSelectorOptions): Promise<RemotePuppeteerElementHandle | null>;
244
- /**
245
- * Convert to a typed element handle.
246
- *
247
- * @remarks
248
- * Throws if the element is not of the specified tag type. Do NOT dispose the original handle - both handles reference the same element.
249
- *
250
- * @example
251
- * Converting to an anchor element:
252
- * ```ts
253
- * const element = await page.$('.class-name-of-anchor');
254
- * const anchor = await element.toElement('a');
255
- * // anchor.href is now typed
256
- * ```
257
- *
258
- * @see https://pptr.dev/api/puppeteer.elementhandle.toelement
259
- */
260
- toElement<K extends keyof HTMLElementTagNameMap>(tagName: K): Promise<RemotePuppeteerElementHandle>;
261
- }
@@ -1,341 +0,0 @@
1
- /**
2
- * AUTO-GENERATED FILE - DO NOT EDIT
3
- *
4
- * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
5
- * Run `pnpm generate:puppeteer` to regenerate.
6
- */
7
- import { extractHandleId, serializeFunctionSource, toHandleRef, } from '../../../internal/transport.js';
8
- import { RemoteBase } from '../remote-base.js';
9
- /**
10
- * RemotePuppeteerElementHandle - Remote Puppeteer ElementHandle API over RPC.
11
- *
12
- * @see https://pptr.dev/api/puppeteer.elementhandle
13
- */
14
- export class RemotePuppeteerElementHandle extends RemoteBase {
15
- /** The handle ID (alias for id, for compatibility). */
16
- handleId;
17
- createElementHandle;
18
- createFrame;
19
- createLocator;
20
- createTouchHandle;
21
- constructor(id, sendRpc, createElementHandle, createFrame, createLocator, createTouchHandle) {
22
- super(id, sendRpc);
23
- this.createElementHandle = createElementHandle;
24
- this.createFrame = createFrame;
25
- this.createLocator = createLocator;
26
- this.createTouchHandle = createTouchHandle;
27
- }
28
- /**
29
- * Click the element.
30
- *
31
- * @see https://pptr.dev/api/puppeteer.elementhandle.click
32
- */
33
- async click(options) {
34
- await this.rpc('click', [options]);
35
- }
36
- /**
37
- * Hover over the element.
38
- *
39
- * @see https://pptr.dev/api/puppeteer.elementhandle.hover
40
- */
41
- async hover() {
42
- await this.rpc('hover', []);
43
- }
44
- /**
45
- * Tap the element (for touch devices).
46
- *
47
- * @see https://pptr.dev/api/puppeteer.elementhandle.tap
48
- */
49
- async tap() {
50
- await this.rpc('tap', []);
51
- }
52
- /**
53
- * Focus the element.
54
- *
55
- * @see https://pptr.dev/api/puppeteer.elementhandle.focus
56
- */
57
- async focus() {
58
- await this.rpc('focus', []);
59
- }
60
- /**
61
- * Type text into the element.
62
- *
63
- * @see https://pptr.dev/api/puppeteer.elementhandle.type
64
- */
65
- async type(text, options) {
66
- await this.rpc('type', [text, options]);
67
- }
68
- /**
69
- * Press a key while focused on the element.
70
- *
71
- * @see https://pptr.dev/api/puppeteer.elementhandle.press
72
- */
73
- async press(key, options) {
74
- await this.rpc('press', [key, options]);
75
- }
76
- /**
77
- * Select options in a <select> element.
78
- * @returns An array of selected option values.
79
- *
80
- * @see https://pptr.dev/api/puppeteer.elementhandle.select
81
- */
82
- async select(...values) {
83
- return this.rpc('select', [...values]);
84
- }
85
- /**
86
- * Upload files to a file input element.
87
- *
88
- * @see https://pptr.dev/api/puppeteer.elementhandle.uploadfile
89
- */
90
- async uploadFile(...filePaths) {
91
- await this.rpc('uploadFile', [...filePaths]);
92
- }
93
- /**
94
- * Scroll the element into view.
95
- *
96
- * @see https://pptr.dev/api/puppeteer.elementhandle.scrollintoview
97
- */
98
- async scrollIntoView() {
99
- await this.rpc('scrollIntoView', []);
100
- }
101
- /**
102
- * Test if the form is compatible with browser autofill. Currently supports credit card autofill in Chrome headless/headful only.
103
- *
104
- * @see https://pptr.dev/api/puppeteer.elementhandle.autofill
105
- */
106
- async autofill(data) {
107
- await this.rpc('autofill', [data]);
108
- }
109
- /**
110
- * Query for a child element.
111
- * @returns The matching element or null if not found.
112
- *
113
- * @see https://pptr.dev/api/puppeteer.elementhandle._
114
- */
115
- async $(selector) {
116
- const result = await this.rpc('$', [selector]);
117
- if (!result)
118
- return null;
119
- return this.createElementHandle(result.id);
120
- }
121
- /**
122
- * Query for all matching child elements.
123
- * @returns An array of matching elements.
124
- *
125
- * @see https://pptr.dev/api/puppeteer.elementhandle.__
126
- */
127
- async $$(selector) {
128
- const results = await this.rpc('$$', [selector]);
129
- return results.map((r) => this.createElementHandle(r.id));
130
- }
131
- /**
132
- * Get a property value.
133
- *
134
- * @see https://pptr.dev/api/puppeteer.elementhandle.getproperty
135
- */
136
- async getProperty(propertyName) {
137
- return this.rpc('getProperty', [propertyName]);
138
- }
139
- /**
140
- * Get the JSON value of the element.
141
- *
142
- * @see https://pptr.dev/api/puppeteer.jshandle.jsonvalue
143
- */
144
- async jsonValue() {
145
- return this.rpc('jsonValue', []);
146
- }
147
- /**
148
- * Check if the element is visible.
149
- *
150
- * @see https://pptr.dev/api/puppeteer.elementhandle.isvisible
151
- */
152
- async isVisible() {
153
- return this.rpc('isVisible', []);
154
- }
155
- /**
156
- * Check if the element is hidden.
157
- *
158
- * @see https://pptr.dev/api/puppeteer.elementhandle.ishidden
159
- */
160
- async isHidden() {
161
- return this.rpc('isHidden', []);
162
- }
163
- /**
164
- * Check if the element intersects the viewport.
165
- *
166
- * @see https://pptr.dev/api/puppeteer.elementhandle.isintersectingviewport
167
- */
168
- async isIntersectingViewport(options) {
169
- return this.rpc('isIntersectingViewport', [options]);
170
- }
171
- /**
172
- * Get the bounding box of the element.
173
- * @returns The bounding box or null if the element is not visible.
174
- *
175
- * @see https://pptr.dev/api/puppeteer.elementhandle.boundingbox
176
- */
177
- async boundingBox() {
178
- return this.rpc('boundingBox', []);
179
- }
180
- /**
181
- * Get the CSS box model of the element.
182
- * @returns The box model or null if the element is not visible.
183
- *
184
- * @see https://pptr.dev/api/puppeteer.elementhandle.boxmodel
185
- */
186
- async boxModel() {
187
- return this.rpc('boxModel', []);
188
- }
189
- /**
190
- * Get a clickable point within the element.
191
- *
192
- * @see https://pptr.dev/api/puppeteer.elementhandle.clickablepoint
193
- */
194
- async clickablePoint(offset) {
195
- return this.rpc('clickablePoint', [offset]);
196
- }
197
- /**
198
- * Evaluate a function in the context of the element.
199
- *
200
- * @remarks
201
- * The element is passed as the first argument to the function.
202
- *
203
- * @see https://pptr.dev/api/puppeteer.elementhandle.evaluate
204
- */
205
- async evaluate(pageFunction, ...args) {
206
- const _pageFunction = serializeFunctionSource(pageFunction);
207
- return this.rpc('evaluate', [_pageFunction, ...args]);
208
- }
209
- /**
210
- * Evaluate a function on the first child matching the selector.
211
- *
212
- * @see https://pptr.dev/api/puppeteer.elementhandle._eval
213
- */
214
- async $eval(selector, pageFunction, ...args) {
215
- const _pageFunction = serializeFunctionSource(pageFunction);
216
- return this.rpc('$eval', [selector, _pageFunction, ...args]);
217
- }
218
- /**
219
- * Evaluate a function on all children matching the selector.
220
- *
221
- * @see https://pptr.dev/api/puppeteer.elementhandle.__eval
222
- */
223
- async $$eval(selector, pageFunction, ...args) {
224
- const _pageFunction = serializeFunctionSource(pageFunction);
225
- return this.rpc('$$eval', [selector, _pageFunction, ...args]);
226
- }
227
- /**
228
- * Get the content frame for iframe elements.
229
- * @returns The frame or null if not an iframe.
230
- *
231
- * @see https://pptr.dev/api/puppeteer.elementhandle.contentframe
232
- */
233
- async contentFrame() {
234
- const result = await this.rpc('contentFrame', []);
235
- if (!result)
236
- return null;
237
- return this.createFrame(result.id);
238
- }
239
- /**
240
- * Drag the element to the given target.
241
- * @param target - Target point or element to drag to.
242
- *
243
- * @see https://pptr.dev/api/puppeteer.elementhandle.drag
244
- */
245
- async drag(target) {
246
- const _target = toHandleRef(target);
247
- return this.rpc('drag', [_target]);
248
- }
249
- /**
250
- * Dispatch a dragenter event.
251
- *
252
- * @remarks
253
- * Deprecated: dragenter is automatically performed during dragging.
254
- *
255
- * @see https://pptr.dev/api/puppeteer.elementhandle.dragenter
256
- */
257
- async dragEnter(data) {
258
- await this.rpc('dragEnter', [data]);
259
- }
260
- /**
261
- * Dispatch a dragover event.
262
- *
263
- * @remarks
264
- * Deprecated: dragover is automatically performed during dragging.
265
- *
266
- * @see https://pptr.dev/api/puppeteer.elementhandle.dragover
267
- */
268
- async dragOver(data) {
269
- await this.rpc('dragOver', [data]);
270
- }
271
- /**
272
- * Drag and drop to another element or point.
273
- * @param target - Target element or point to drop onto.
274
- *
275
- * @see https://pptr.dev/api/puppeteer.elementhandle.draganddrop
276
- */
277
- async dragAndDrop(target, options) {
278
- const _target = toHandleRef(target);
279
- await this.rpc('dragAndDrop', [_target, options]);
280
- }
281
- /**
282
- * Drop the given element onto the current one.
283
- * @param element - Element to drop.
284
- *
285
- * @see https://pptr.dev/api/puppeteer.elementhandle.drop
286
- */
287
- async drop(element) {
288
- const _element = extractHandleId(element);
289
- await this.rpc('drop', [_element]);
290
- }
291
- /**
292
- * Move the touch to the center of the element.
293
- *
294
- * @remarks
295
- * Scrolls element into view if needed.
296
- *
297
- * @see https://pptr.dev/api/puppeteer.elementhandle.touchmove
298
- */
299
- async touchMove(touch) {
300
- await this.rpc('touchMove', [touch]);
301
- }
302
- /**
303
- * End the first active touch.
304
- *
305
- * @see https://pptr.dev/api/puppeteer.elementhandle.touchend
306
- */
307
- async touchEnd() {
308
- await this.rpc('touchEnd', []);
309
- }
310
- /**
311
- * Wait for a child element to appear.
312
- *
313
- * @see https://pptr.dev/api/puppeteer.elementhandle.waitforselector
314
- */
315
- async waitForSelector(selector, options) {
316
- const result = await this.rpc('waitForSelector', [selector, options]);
317
- if (!result)
318
- return null;
319
- return this.createElementHandle(result.id);
320
- }
321
- /**
322
- * Convert to a typed element handle.
323
- *
324
- * @remarks
325
- * Throws if the element is not of the specified tag type. Do NOT dispose the original handle - both handles reference the same element.
326
- *
327
- * @example
328
- * Converting to an anchor element:
329
- * ```ts
330
- * const element = await page.$('.class-name-of-anchor');
331
- * const anchor = await element.toElement('a');
332
- * // anchor.href is now typed
333
- * ```
334
- *
335
- * @see https://pptr.dev/api/puppeteer.elementhandle.toelement
336
- */
337
- async toElement(tagName) {
338
- const result = await this.rpc('toElement', [tagName]);
339
- return this.createElementHandle(result.id);
340
- }
341
- }
@@ -1,34 +0,0 @@
1
- /**
2
- * AUTO-GENERATED FILE - DO NOT EDIT
3
- *
4
- * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
5
- * Run `pnpm generate:puppeteer` to regenerate.
6
- */
7
- import type { SimpleRpcSender } from '../../../internal/transport.js';
8
- /**
9
- * RemotePuppeteerFileChooser - Remote Puppeteer FileChooser API over RPC.
10
- *
11
- * @see https://pptr.dev/api/puppeteer.filechooser
12
- */
13
- export declare class RemotePuppeteerFileChooser {
14
- readonly id: string;
15
- protected sendRpc: SimpleRpcSender;
16
- /** Whether the file chooser allows multiple file selection. */
17
- private readonly _isMultiple;
18
- constructor(id: string, sendRpc: SimpleRpcSender, isMultiple: boolean);
19
- /**
20
- * Whether file chooser allows multiple file selection.
21
- * @see https://pptr.dev/api/puppeteer.filechooser.ismultiple
22
- */
23
- isMultiple(): boolean;
24
- /**
25
- * Accept the file chooser request with the given file paths.
26
- * @see https://pptr.dev/api/puppeteer.filechooser.accept
27
- */
28
- accept(paths: string[]): Promise<void>;
29
- /**
30
- * Close the file chooser without selecting any files.
31
- * @see https://pptr.dev/api/puppeteer.filechooser.cancel
32
- */
33
- cancel(): Promise<void>;
34
- }
@@ -1,43 +0,0 @@
1
- /**
2
- * AUTO-GENERATED FILE - DO NOT EDIT
3
- *
4
- * Generated from: packages/automation-spec/src/drivers/puppeteer/methods/puppeteer-methods.ts
5
- * Run `pnpm generate:puppeteer` to regenerate.
6
- */
7
- /**
8
- * RemotePuppeteerFileChooser - Remote Puppeteer FileChooser API over RPC.
9
- *
10
- * @see https://pptr.dev/api/puppeteer.filechooser
11
- */
12
- export class RemotePuppeteerFileChooser {
13
- id;
14
- sendRpc;
15
- /** Whether the file chooser allows multiple file selection. */
16
- _isMultiple;
17
- constructor(id, sendRpc, isMultiple) {
18
- this.id = id;
19
- this.sendRpc = sendRpc;
20
- this._isMultiple = isMultiple;
21
- }
22
- /**
23
- * Whether file chooser allows multiple file selection.
24
- * @see https://pptr.dev/api/puppeteer.filechooser.ismultiple
25
- */
26
- isMultiple() {
27
- return this._isMultiple;
28
- }
29
- /**
30
- * Accept the file chooser request with the given file paths.
31
- * @see https://pptr.dev/api/puppeteer.filechooser.accept
32
- */
33
- async accept(paths) {
34
- await this.sendRpc('fileChooser:accept', [this.id, paths]);
35
- }
36
- /**
37
- * Close the file chooser without selecting any files.
38
- * @see https://pptr.dev/api/puppeteer.filechooser.cancel
39
- */
40
- async cancel() {
41
- await this.sendRpc('fileChooser:cancel', [this.id]);
42
- }
43
- }