@bctrl/sdk 1.0.1 → 1.0.3

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 (277) hide show
  1. package/README.md +28 -29
  2. package/dist/bctrl.d.ts +22 -36
  3. package/dist/bctrl.js +40 -75
  4. package/dist/errors.d.ts +49 -43
  5. package/dist/errors.js +83 -120
  6. package/dist/files.d.ts +31 -0
  7. package/dist/files.js +97 -0
  8. package/dist/http.d.ts +18 -0
  9. package/dist/http.js +135 -0
  10. package/dist/index.d.ts +9 -12
  11. package/dist/index.js +7 -23
  12. package/dist/invocations.d.ts +86 -0
  13. package/dist/invocations.js +159 -0
  14. package/dist/pagination.d.ts +2 -0
  15. package/dist/pagination.js +13 -0
  16. package/dist/runs.d.ts +40 -0
  17. package/dist/runs.js +105 -0
  18. package/dist/runtimes.d.ts +69 -0
  19. package/dist/runtimes.js +202 -0
  20. package/dist/spaces.d.ts +40 -0
  21. package/dist/spaces.js +96 -0
  22. package/dist/types.d.ts +413 -0
  23. package/dist/types.js +1 -0
  24. package/dist/utils.d.ts +4 -0
  25. package/dist/utils.js +27 -0
  26. package/dist/version.js +2 -2
  27. package/package.json +4 -21
  28. package/dist/agents/browser-use/index.d.ts +0 -1
  29. package/dist/agents/browser-use/index.js +0 -9
  30. package/dist/agents/browser-use/namespace.d.ts +0 -39
  31. package/dist/agents/browser-use/namespace.js +0 -93
  32. package/dist/agents/index.d.ts +0 -2
  33. package/dist/agents/index.js +0 -17
  34. package/dist/agents/stagehand/core.d.ts +0 -93
  35. package/dist/agents/stagehand/core.js +0 -144
  36. package/dist/agents/stagehand/index.d.ts +0 -3
  37. package/dist/agents/stagehand/index.js +0 -24
  38. package/dist/agents/stagehand/namespace.d.ts +0 -51
  39. package/dist/agents/stagehand/namespace.js +0 -65
  40. package/dist/ai-credentials/client.d.ts +0 -12
  41. package/dist/ai-credentials/client.js +0 -70
  42. package/dist/ai-credentials/index.d.ts +0 -1
  43. package/dist/ai-credentials/index.js +0 -1
  44. package/dist/base/event-binding.d.ts +0 -7
  45. package/dist/base/event-binding.js +0 -23
  46. package/dist/base/types.d.ts +0 -109
  47. package/dist/base/types.js +0 -4
  48. package/dist/browser-extensions/client.d.ts +0 -15
  49. package/dist/browser-extensions/client.js +0 -72
  50. package/dist/browser-extensions/index.d.ts +0 -2
  51. package/dist/browser-extensions/index.js +0 -1
  52. package/dist/browser-profiles/client.d.ts +0 -11
  53. package/dist/browser-profiles/client.js +0 -63
  54. package/dist/browser-profiles/index.d.ts +0 -1
  55. package/dist/browser-profiles/index.js +0 -1
  56. package/dist/captcha/index.d.ts +0 -1
  57. package/dist/captcha/index.js +0 -1
  58. package/dist/captcha/namespace.d.ts +0 -34
  59. package/dist/captcha/namespace.js +0 -41
  60. package/dist/client/index.d.ts +0 -1
  61. package/dist/client/index.js +0 -1
  62. package/dist/client/rpc.d.ts +0 -83
  63. package/dist/client/rpc.js +0 -354
  64. package/dist/config.d.ts +0 -5
  65. package/dist/config.js +0 -28
  66. package/dist/constants/browser.d.ts +0 -2
  67. package/dist/constants/browser.js +0 -1
  68. package/dist/contracts/agent-tools.d.ts +0 -45
  69. package/dist/contracts/agent-tools.js +0 -31
  70. package/dist/contracts/automation.d.ts +0 -265
  71. package/dist/contracts/automation.js +0 -109
  72. package/dist/contracts/browser-management.d.ts +0 -179
  73. package/dist/contracts/browser-management.js +0 -95
  74. package/dist/contracts/browser-use.d.ts +0 -136
  75. package/dist/contracts/browser-use.js +0 -93
  76. package/dist/contracts/captcha.d.ts +0 -114
  77. package/dist/contracts/captcha.js +0 -40
  78. package/dist/contracts/desktop.d.ts +0 -223
  79. package/dist/contracts/desktop.js +0 -121
  80. package/dist/contracts/drivers/playwright.d.ts +0 -2008
  81. package/dist/contracts/drivers/playwright.js +0 -2033
  82. package/dist/contracts/drivers/puppeteer.d.ts +0 -1221
  83. package/dist/contracts/drivers/puppeteer.js +0 -941
  84. package/dist/contracts/drivers/selenium.d.ts +0 -156
  85. package/dist/contracts/drivers/selenium.js +0 -61
  86. package/dist/contracts/drivers/stagehand.d.ts +0 -155
  87. package/dist/contracts/drivers/stagehand.js +0 -7
  88. package/dist/contracts/extensions.d.ts +0 -13
  89. package/dist/contracts/extensions.js +0 -9
  90. package/dist/contracts/index.d.ts +0 -13
  91. package/dist/contracts/index.js +0 -13
  92. package/dist/contracts/public-api.d.ts +0 -360
  93. package/dist/contracts/public-api.js +0 -17
  94. package/dist/contracts/runtime.d.ts +0 -81
  95. package/dist/contracts/runtime.js +0 -16
  96. package/dist/contracts/stagehand.d.ts +0 -253
  97. package/dist/contracts/stagehand.js +0 -145
  98. package/dist/contracts/storage.d.ts +0 -51
  99. package/dist/contracts/storage.js +0 -56
  100. package/dist/contracts/vault.d.ts +0 -119
  101. package/dist/contracts/vault.js +0 -112
  102. package/dist/contracts/version.d.ts +0 -3
  103. package/dist/contracts/version.js +0 -16
  104. package/dist/desktop.d.ts +0 -2
  105. package/dist/desktop.js +0 -3
  106. package/dist/drivers/desktop/index.d.ts +0 -65
  107. package/dist/drivers/desktop/index.js +0 -68
  108. package/dist/drivers/desktop/session.d.ts +0 -313
  109. package/dist/drivers/desktop/session.js +0 -432
  110. package/dist/drivers/playwright/event-emitter.d.ts +0 -160
  111. package/dist/drivers/playwright/event-emitter.js +0 -297
  112. package/dist/drivers/playwright/generated/api-request-context.d.ts +0 -137
  113. package/dist/drivers/playwright/generated/api-request-context.js +0 -154
  114. package/dist/drivers/playwright/generated/api-response.d.ts +0 -119
  115. package/dist/drivers/playwright/generated/api-response.js +0 -123
  116. package/dist/drivers/playwright/generated/browser-context.d.ts +0 -284
  117. package/dist/drivers/playwright/generated/browser-context.js +0 -458
  118. package/dist/drivers/playwright/generated/browser.d.ts +0 -120
  119. package/dist/drivers/playwright/generated/browser.js +0 -151
  120. package/dist/drivers/playwright/generated/clock.d.ts +0 -80
  121. package/dist/drivers/playwright/generated/clock.js +0 -94
  122. package/dist/drivers/playwright/generated/console-message.d.ts +0 -94
  123. package/dist/drivers/playwright/generated/console-message.js +0 -89
  124. package/dist/drivers/playwright/generated/coverage.d.ts +0 -57
  125. package/dist/drivers/playwright/generated/coverage.js +0 -66
  126. package/dist/drivers/playwright/generated/dialog.d.ts +0 -79
  127. package/dist/drivers/playwright/generated/dialog.js +0 -80
  128. package/dist/drivers/playwright/generated/element-handle.d.ts +0 -399
  129. package/dist/drivers/playwright/generated/element-handle.js +0 -501
  130. package/dist/drivers/playwright/generated/frame-locator.d.ts +0 -34
  131. package/dist/drivers/playwright/generated/frame-locator.js +0 -63
  132. package/dist/drivers/playwright/generated/frame.d.ts +0 -557
  133. package/dist/drivers/playwright/generated/frame.js +0 -634
  134. package/dist/drivers/playwright/generated/js-handle.d.ts +0 -72
  135. package/dist/drivers/playwright/generated/js-handle.js +0 -92
  136. package/dist/drivers/playwright/generated/keyboard.d.ts +0 -103
  137. package/dist/drivers/playwright/generated/keyboard.js +0 -113
  138. package/dist/drivers/playwright/generated/locator.d.ts +0 -795
  139. package/dist/drivers/playwright/generated/locator.js +0 -974
  140. package/dist/drivers/playwright/generated/mouse.d.ts +0 -97
  141. package/dist/drivers/playwright/generated/mouse.js +0 -109
  142. package/dist/drivers/playwright/generated/page.d.ts +0 -762
  143. package/dist/drivers/playwright/generated/page.js +0 -988
  144. package/dist/drivers/playwright/generated/touchscreen.d.ts +0 -34
  145. package/dist/drivers/playwright/generated/touchscreen.js +0 -37
  146. package/dist/drivers/playwright/generated/tracing.d.ts +0 -78
  147. package/dist/drivers/playwright/generated/tracing.js +0 -80
  148. package/dist/drivers/playwright/generated/worker.d.ts +0 -53
  149. package/dist/drivers/playwright/generated/worker.js +0 -59
  150. package/dist/drivers/playwright/index.d.ts +0 -19
  151. package/dist/drivers/playwright/index.js +0 -20
  152. package/dist/drivers/playwright/remote-base.d.ts +0 -62
  153. package/dist/drivers/playwright/remote-base.js +0 -86
  154. package/dist/drivers/playwright/types.d.ts +0 -148
  155. package/dist/drivers/playwright/types.js +0 -8
  156. package/dist/drivers/puppeteer/errors.d.ts +0 -50
  157. package/dist/drivers/puppeteer/errors.js +0 -71
  158. package/dist/drivers/puppeteer/event-emitter.d.ts +0 -145
  159. package/dist/drivers/puppeteer/event-emitter.js +0 -259
  160. package/dist/drivers/puppeteer/generated/accessibility.d.ts +0 -77
  161. package/dist/drivers/puppeteer/generated/accessibility.js +0 -74
  162. package/dist/drivers/puppeteer/generated/browser-context.d.ts +0 -116
  163. package/dist/drivers/puppeteer/generated/browser-context.js +0 -168
  164. package/dist/drivers/puppeteer/generated/browser.d.ts +0 -169
  165. package/dist/drivers/puppeteer/generated/browser.js +0 -246
  166. package/dist/drivers/puppeteer/generated/console-message.d.ts +0 -54
  167. package/dist/drivers/puppeteer/generated/console-message.js +0 -69
  168. package/dist/drivers/puppeteer/generated/coverage.d.ts +0 -49
  169. package/dist/drivers/puppeteer/generated/coverage.js +0 -57
  170. package/dist/drivers/puppeteer/generated/dialog.d.ts +0 -46
  171. package/dist/drivers/puppeteer/generated/dialog.js +0 -60
  172. package/dist/drivers/puppeteer/generated/element-handle.d.ts +0 -261
  173. package/dist/drivers/puppeteer/generated/element-handle.js +0 -341
  174. package/dist/drivers/puppeteer/generated/file-chooser.d.ts +0 -34
  175. package/dist/drivers/puppeteer/generated/file-chooser.js +0 -43
  176. package/dist/drivers/puppeteer/generated/frame.d.ts +0 -221
  177. package/dist/drivers/puppeteer/generated/frame.js +0 -302
  178. package/dist/drivers/puppeteer/generated/http-request.d.ts +0 -195
  179. package/dist/drivers/puppeteer/generated/http-request.js +0 -243
  180. package/dist/drivers/puppeteer/generated/http-response.d.ts +0 -142
  181. package/dist/drivers/puppeteer/generated/http-response.js +0 -169
  182. package/dist/drivers/puppeteer/generated/js-handle.d.ts +0 -104
  183. package/dist/drivers/puppeteer/generated/js-handle.js +0 -125
  184. package/dist/drivers/puppeteer/generated/keyboard.d.ts +0 -79
  185. package/dist/drivers/puppeteer/generated/keyboard.js +0 -89
  186. package/dist/drivers/puppeteer/generated/locator.d.ts +0 -141
  187. package/dist/drivers/puppeteer/generated/locator.js +0 -164
  188. package/dist/drivers/puppeteer/generated/mouse.d.ts +0 -74
  189. package/dist/drivers/puppeteer/generated/mouse.js +0 -94
  190. package/dist/drivers/puppeteer/generated/page.d.ts +0 -604
  191. package/dist/drivers/puppeteer/generated/page.js +0 -776
  192. package/dist/drivers/puppeteer/generated/target.d.ts +0 -105
  193. package/dist/drivers/puppeteer/generated/target.js +0 -123
  194. package/dist/drivers/puppeteer/generated/touchscreen.d.ts +0 -87
  195. package/dist/drivers/puppeteer/generated/touchscreen.js +0 -103
  196. package/dist/drivers/puppeteer/generated/tracing.d.ts +0 -38
  197. package/dist/drivers/puppeteer/generated/tracing.js +0 -43
  198. package/dist/drivers/puppeteer/generated/web-worker.d.ts +0 -63
  199. package/dist/drivers/puppeteer/generated/web-worker.js +0 -73
  200. package/dist/drivers/puppeteer/index.d.ts +0 -21
  201. package/dist/drivers/puppeteer/index.js +0 -23
  202. package/dist/drivers/puppeteer/remote-base.d.ts +0 -57
  203. package/dist/drivers/puppeteer/remote-base.js +0 -79
  204. package/dist/drivers/puppeteer/types.d.ts +0 -178
  205. package/dist/drivers/puppeteer/types.js +0 -8
  206. package/dist/drivers/selenium/driver.d.ts +0 -28
  207. package/dist/drivers/selenium/driver.js +0 -169
  208. package/dist/drivers/selenium/element.d.ts +0 -34
  209. package/dist/drivers/selenium/element.js +0 -73
  210. package/dist/drivers/selenium/index.d.ts +0 -3
  211. package/dist/drivers/selenium/index.js +0 -5
  212. package/dist/drivers/selenium/types.d.ts +0 -2
  213. package/dist/drivers/selenium/types.js +0 -12
  214. package/dist/drivers/stagehand/generated/context.d.ts +0 -127
  215. package/dist/drivers/stagehand/generated/context.js +0 -153
  216. package/dist/drivers/stagehand/generated/locator.d.ts +0 -324
  217. package/dist/drivers/stagehand/generated/locator.js +0 -368
  218. package/dist/drivers/stagehand/generated/page.d.ts +0 -377
  219. package/dist/drivers/stagehand/generated/page.js +0 -439
  220. package/dist/drivers/stagehand/generated/response.d.ts +0 -197
  221. package/dist/drivers/stagehand/generated/response.js +0 -232
  222. package/dist/drivers/stagehand/index.d.ts +0 -5
  223. package/dist/drivers/stagehand/index.js +0 -8
  224. package/dist/drivers/stagehand/types.d.ts +0 -1
  225. package/dist/drivers/stagehand/types.js +0 -7
  226. package/dist/extensions/client.d.ts +0 -47
  227. package/dist/extensions/client.js +0 -154
  228. package/dist/extensions/index.d.ts +0 -1
  229. package/dist/extensions/index.js +0 -1
  230. package/dist/internal/dev-client.d.ts +0 -5
  231. package/dist/internal/dev-client.js +0 -9
  232. package/dist/internal/rpc-targets.d.ts +0 -17
  233. package/dist/internal/rpc-targets.js +0 -58
  234. package/dist/internal/serialization.d.ts +0 -32
  235. package/dist/internal/serialization.js +0 -42
  236. package/dist/internal/transport.d.ts +0 -24
  237. package/dist/internal/transport.js +0 -29
  238. package/dist/playwright.d.ts +0 -1
  239. package/dist/playwright.js +0 -2
  240. package/dist/puppeteer.d.ts +0 -1
  241. package/dist/puppeteer.js +0 -2
  242. package/dist/selenium.d.ts +0 -1
  243. package/dist/selenium.js +0 -2
  244. package/dist/stagehand.d.ts +0 -1
  245. package/dist/stagehand.js +0 -2
  246. package/dist/storage/client.d.ts +0 -151
  247. package/dist/storage/client.js +0 -329
  248. package/dist/storage/index.d.ts +0 -2
  249. package/dist/storage/index.js +0 -4
  250. package/dist/telemetry.d.ts +0 -18
  251. package/dist/telemetry.js +0 -93
  252. package/dist/updates/client.d.ts +0 -8
  253. package/dist/updates/client.js +0 -128
  254. package/dist/updates/index.d.ts +0 -1
  255. package/dist/updates/index.js +0 -1
  256. package/dist/utils/http.d.ts +0 -39
  257. package/dist/utils/http.js +0 -88
  258. package/dist/utils/index.d.ts +0 -4
  259. package/dist/utils/index.js +0 -4
  260. package/dist/utils/logger.d.ts +0 -27
  261. package/dist/utils/logger.js +0 -74
  262. package/dist/utils/schema.d.ts +0 -17
  263. package/dist/utils/schema.js +0 -31
  264. package/dist/utils/url.d.ts +0 -5
  265. package/dist/utils/url.js +0 -7
  266. package/dist/vault/client.d.ts +0 -43
  267. package/dist/vault/client.js +0 -123
  268. package/dist/vault/index.d.ts +0 -1
  269. package/dist/vault/index.js +0 -1
  270. package/dist/workspaces/browser-runtime.d.ts +0 -251
  271. package/dist/workspaces/browser-runtime.js +0 -1025
  272. package/dist/workspaces/client.d.ts +0 -48
  273. package/dist/workspaces/client.js +0 -222
  274. package/dist/workspaces/index.d.ts +0 -2
  275. package/dist/workspaces/index.js +0 -2
  276. package/dist/workspaces/runtime-event-pump.d.ts +0 -65
  277. package/dist/workspaces/runtime-event-pump.js +0 -716
@@ -1,221 +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 { PuppeteerClickOptions, PuppeteerFrameAddScriptTagOptions, PuppeteerFrameAddStyleTagOptions, PuppeteerGotoOptions, PuppeteerHTTPResponse, PuppeteerKeyboardTypeOptions, PuppeteerWaitForNavigationOptions, PuppeteerWaitForSelectorOptions } from '../types.js';
10
- import type { RemotePuppeteerElementHandle } from './element-handle.js';
11
- import type { RemotePuppeteerJSHandle } from './js-handle.js';
12
- import type { RemotePuppeteerLocator } from './locator.js';
13
- import type { RemotePuppeteerPage } from './page.js';
14
- /**
15
- * RemotePuppeteerFrame - Remote Puppeteer Frame API over RPC.
16
- *
17
- * @see https://pptr.dev/api/puppeteer.frame
18
- */
19
- export declare class RemotePuppeteerFrame extends RemoteBase {
20
- /** Whether this frame has been detached. */
21
- _isDetached: boolean;
22
- private createElementHandle;
23
- private createFrame;
24
- private createLocator;
25
- private createJSHandle;
26
- private getPage;
27
- constructor(id: string, sendRpc: SimpleRpcSender, createElementHandle: (handleId: string) => RemotePuppeteerElementHandle, createFrame: (frameId: string) => RemotePuppeteerFrame, createLocator: (selector: string) => RemotePuppeteerLocator, createJSHandle: (handleId: string) => RemotePuppeteerJSHandle, getPage: () => RemotePuppeteerPage);
28
- /**
29
- * The page associated with this frame.
30
- */
31
- page(): RemotePuppeteerPage;
32
- /**
33
- * Creates a Locator for the given selector.
34
- */
35
- locator(selector: string): RemotePuppeteerLocator;
36
- /**
37
- * Evaluates a function in the frame's context and returns a handle to the result.
38
- */
39
- evaluateHandle<Params extends unknown[] = unknown[], Func extends (...args: Params) => unknown = (...args: Params) => unknown>(pageFunction: Func | string, ...args: Params): Promise<RemotePuppeteerJSHandle<Awaited<ReturnType<Func>>>>;
40
- /**
41
- * Wait for a function to return a truthy value.
42
- */
43
- waitForFunction<Params extends unknown[] = unknown[], Func extends (...args: Params) => unknown = (...args: Params) => unknown>(pageFunction: Func | string, options?: {
44
- timeout?: number;
45
- polling?: number | 'raf' | 'mutation';
46
- }, ...args: Params): Promise<RemotePuppeteerJSHandle<Awaited<ReturnType<Func>>>>;
47
- /**
48
- * Is `true` if the frame has been detached. Otherwise, `false`.
49
- *
50
- * @see https://pptr.dev/api/puppeteer.frame.detached
51
- */
52
- detached(): boolean;
53
- /**
54
- * Whether this frame is detached.
55
- *
56
- * @remarks
57
- * @deprecated Use the `detached` getter.
58
- *
59
- * @see https://pptr.dev/api/puppeteer.frame.isdetached
60
- */
61
- isDetached(): boolean;
62
- /**
63
- * The frame element associated with this frame, if any.
64
- *
65
- * @remarks
66
- * Returns the ElementHandle for the <iframe> or <frame> tag for this frame. Returns null for the main frame.
67
- *
68
- * @see https://pptr.dev/api/puppeteer.frame.frameelement
69
- */
70
- frameElement(): Promise<RemotePuppeteerElementHandle | null>;
71
- /**
72
- * The frame's URL.
73
- *
74
- * @see https://pptr.dev/api/puppeteer.frame.url
75
- */
76
- url(): Promise<string>;
77
- /**
78
- * The frame's name attribute as specified in the tag.
79
- *
80
- * @see https://pptr.dev/api/puppeteer.frame.name
81
- */
82
- name(): Promise<string>;
83
- /**
84
- * The frame's title.
85
- *
86
- * @see https://pptr.dev/api/puppeteer.frame.title
87
- */
88
- title(): Promise<string>;
89
- /**
90
- * The full HTML contents of the frame.
91
- *
92
- * @see https://pptr.dev/api/puppeteer.frame.content
93
- */
94
- content(): Promise<string>;
95
- /**
96
- * Set the content of the frame.
97
- *
98
- * @see https://pptr.dev/api/puppeteer.frame.setcontent
99
- */
100
- setContent(html: string, options?: {
101
- timeout?: number;
102
- waitUntil?: string;
103
- }): Promise<void>;
104
- /**
105
- * The parent frame, if any.
106
- *
107
- * @remarks
108
- * Returns null for the main frame.
109
- *
110
- * @see https://pptr.dev/api/puppeteer.frame.parentframe
111
- */
112
- parentFrame(): Promise<RemotePuppeteerFrame | null>;
113
- /**
114
- * Child frames of this frame.
115
- *
116
- * @see https://pptr.dev/api/puppeteer.frame.childframes
117
- */
118
- childFrames(): Promise<RemotePuppeteerFrame[]>;
119
- /**
120
- * Is this the main frame?
121
- *
122
- * @see https://pptr.dev/api/puppeteer.frame.ismainframe
123
- */
124
- isMainFrame(): Promise<boolean>;
125
- /**
126
- * Navigate the frame to a URL.
127
- *
128
- * @see https://pptr.dev/api/puppeteer.frame.goto
129
- */
130
- goto(url: string, options?: PuppeteerGotoOptions): Promise<PuppeteerHTTPResponse | null>;
131
- /**
132
- * Wait for navigation to complete.
133
- *
134
- * @see https://pptr.dev/api/puppeteer.frame.waitfornavigation
135
- */
136
- waitForNavigation(options?: PuppeteerWaitForNavigationOptions): Promise<PuppeteerHTTPResponse | null>;
137
- /**
138
- * Query for a single element.
139
- *
140
- * @see https://pptr.dev/api/puppeteer.frame._
141
- */
142
- $(selector: string): Promise<RemotePuppeteerElementHandle | null>;
143
- /**
144
- * Query for all matching elements.
145
- *
146
- * @see https://pptr.dev/api/puppeteer.frame.__
147
- */
148
- $$(selector: string): Promise<RemotePuppeteerElementHandle[]>;
149
- /**
150
- * Wait for a selector to appear.
151
- *
152
- * @see https://pptr.dev/api/puppeteer.frame.waitforselector
153
- */
154
- waitForSelector(selector: string, options?: PuppeteerWaitForSelectorOptions): Promise<RemotePuppeteerElementHandle | null>;
155
- /**
156
- * Click on an element.
157
- *
158
- * @see https://pptr.dev/api/puppeteer.frame.click
159
- */
160
- click(selector: string, options?: PuppeteerClickOptions): Promise<void>;
161
- /**
162
- * Type text into an element.
163
- *
164
- * @see https://pptr.dev/api/puppeteer.frame.type
165
- */
166
- type(selector: string, text: string, options?: PuppeteerKeyboardTypeOptions): Promise<void>;
167
- /**
168
- * Focus on an element.
169
- *
170
- * @see https://pptr.dev/api/puppeteer.frame.focus
171
- */
172
- focus(selector: string): Promise<void>;
173
- /**
174
- * Hover over an element.
175
- *
176
- * @see https://pptr.dev/api/puppeteer.frame.hover
177
- */
178
- hover(selector: string): Promise<void>;
179
- /**
180
- * Select options in a <select> element.
181
- *
182
- * @see https://pptr.dev/api/puppeteer.frame.select
183
- */
184
- select(selector: string, ...values: string[]): Promise<string[]>;
185
- /**
186
- * Tap on an element.
187
- *
188
- * @see https://pptr.dev/api/puppeteer.frame.tap
189
- */
190
- tap(selector: string): Promise<void>;
191
- /**
192
- * Evaluate JavaScript in the frame context.
193
- *
194
- * @see https://pptr.dev/api/puppeteer.frame.evaluate
195
- */
196
- evaluate<T = unknown>(pageFunction: string | ((...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
197
- /**
198
- * Evaluate JavaScript on a selected element.
199
- *
200
- * @see https://pptr.dev/api/puppeteer.frame._eval
201
- */
202
- $eval<T = unknown>(selector: string, pageFunction: string | ((el: Element, ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
203
- /**
204
- * Evaluate JavaScript on all matching elements.
205
- *
206
- * @see https://pptr.dev/api/puppeteer.frame.__eval
207
- */
208
- $$eval<T = unknown>(selector: string, pageFunction: string | ((els: Element[], ...args: unknown[]) => T | Promise<T>), ...args: unknown[]): Promise<T>;
209
- /**
210
- * Add a script tag to the frame.
211
- *
212
- * @see https://pptr.dev/api/puppeteer.frame.addscripttag
213
- */
214
- addScriptTag(options: PuppeteerFrameAddScriptTagOptions): Promise<RemotePuppeteerElementHandle>;
215
- /**
216
- * Add a style tag to the frame.
217
- *
218
- * @see https://pptr.dev/api/puppeteer.frame.addstyletag
219
- */
220
- addStyleTag(options: PuppeteerFrameAddStyleTagOptions): Promise<RemotePuppeteerElementHandle>;
221
- }
@@ -1,302 +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 { serializeFunctionSource } from '../../../internal/transport.js';
8
- import { RemoteBase } from '../remote-base.js';
9
- /**
10
- * RemotePuppeteerFrame - Remote Puppeteer Frame API over RPC.
11
- *
12
- * @see https://pptr.dev/api/puppeteer.frame
13
- */
14
- export class RemotePuppeteerFrame extends RemoteBase {
15
- /** Whether this frame has been detached. */
16
- _isDetached;
17
- createElementHandle;
18
- createFrame;
19
- createLocator;
20
- createJSHandle;
21
- getPage;
22
- constructor(id, sendRpc, createElementHandle, createFrame, createLocator, createJSHandle, getPage) {
23
- super(id, sendRpc);
24
- this.createElementHandle = createElementHandle;
25
- this.createFrame = createFrame;
26
- this.createLocator = createLocator;
27
- this.createJSHandle = createJSHandle;
28
- this.getPage = getPage;
29
- }
30
- /**
31
- * The page associated with this frame.
32
- */
33
- page() {
34
- return this.getPage();
35
- }
36
- /**
37
- * Creates a Locator for the given selector.
38
- */
39
- locator(selector) {
40
- return this.createLocator(selector);
41
- }
42
- /**
43
- * Evaluates a function in the frame's context and returns a handle to the result.
44
- */
45
- async evaluateHandle(pageFunction, ...args) {
46
- const _pageFunction = serializeFunctionSource(pageFunction);
47
- const result = await this.rpc('evaluateHandle', [_pageFunction, ...args]);
48
- return this.createJSHandle(result.id);
49
- }
50
- /**
51
- * Wait for a function to return a truthy value.
52
- */
53
- async waitForFunction(pageFunction, options, ...args) {
54
- const _pageFunction = serializeFunctionSource(pageFunction);
55
- const result = await this.rpc('waitForFunction', [_pageFunction, options, ...args]);
56
- return this.createJSHandle(result.id);
57
- }
58
- /**
59
- * Is `true` if the frame has been detached. Otherwise, `false`.
60
- *
61
- * @see https://pptr.dev/api/puppeteer.frame.detached
62
- */
63
- detached() {
64
- return this._isDetached;
65
- }
66
- /**
67
- * Whether this frame is detached.
68
- *
69
- * @remarks
70
- * @deprecated Use the `detached` getter.
71
- *
72
- * @see https://pptr.dev/api/puppeteer.frame.isdetached
73
- */
74
- isDetached() {
75
- return this._isDetached;
76
- }
77
- /**
78
- * The frame element associated with this frame, if any.
79
- *
80
- * @remarks
81
- * Returns the ElementHandle for the <iframe> or <frame> tag for this frame. Returns null for the main frame.
82
- *
83
- * @see https://pptr.dev/api/puppeteer.frame.frameelement
84
- */
85
- async frameElement() {
86
- const result = await this.rpc('frameElement', []);
87
- if (!result)
88
- return null;
89
- return this.createElementHandle(result.id);
90
- }
91
- /**
92
- * The frame's URL.
93
- *
94
- * @see https://pptr.dev/api/puppeteer.frame.url
95
- */
96
- async url() {
97
- return this.rpc('url', []);
98
- }
99
- /**
100
- * The frame's name attribute as specified in the tag.
101
- *
102
- * @see https://pptr.dev/api/puppeteer.frame.name
103
- */
104
- async name() {
105
- return this.rpc('name', []);
106
- }
107
- /**
108
- * The frame's title.
109
- *
110
- * @see https://pptr.dev/api/puppeteer.frame.title
111
- */
112
- async title() {
113
- return this.rpc('title', []);
114
- }
115
- /**
116
- * The full HTML contents of the frame.
117
- *
118
- * @see https://pptr.dev/api/puppeteer.frame.content
119
- */
120
- async content() {
121
- return this.rpc('content', []);
122
- }
123
- /**
124
- * Set the content of the frame.
125
- *
126
- * @see https://pptr.dev/api/puppeteer.frame.setcontent
127
- */
128
- async setContent(html, options) {
129
- await this.rpc('setContent', [html, options]);
130
- }
131
- /**
132
- * The parent frame, if any.
133
- *
134
- * @remarks
135
- * Returns null for the main frame.
136
- *
137
- * @see https://pptr.dev/api/puppeteer.frame.parentframe
138
- */
139
- async parentFrame() {
140
- const result = await this.rpc('parentFrame', []);
141
- if (!result)
142
- return null;
143
- return this.createFrame(result.id);
144
- }
145
- /**
146
- * Child frames of this frame.
147
- *
148
- * @see https://pptr.dev/api/puppeteer.frame.childframes
149
- */
150
- async childFrames() {
151
- const results = await this.rpc('childFrames', []);
152
- return results.map((r) => this.createFrame(r.id));
153
- }
154
- /**
155
- * Is this the main frame?
156
- *
157
- * @see https://pptr.dev/api/puppeteer.frame.ismainframe
158
- */
159
- async isMainFrame() {
160
- return this.rpc('isMainFrame', []);
161
- }
162
- /**
163
- * Navigate the frame to a URL.
164
- *
165
- * @see https://pptr.dev/api/puppeteer.frame.goto
166
- */
167
- async goto(url, options) {
168
- return this.rpc('goto', [url, options]);
169
- }
170
- /**
171
- * Wait for navigation to complete.
172
- *
173
- * @see https://pptr.dev/api/puppeteer.frame.waitfornavigation
174
- */
175
- async waitForNavigation(options) {
176
- return this.rpc('waitForNavigation', [options]);
177
- }
178
- /**
179
- * Query for a single element.
180
- *
181
- * @see https://pptr.dev/api/puppeteer.frame._
182
- */
183
- async $(selector) {
184
- const result = await this.rpc('$', [selector]);
185
- if (!result)
186
- return null;
187
- return this.createElementHandle(result.id);
188
- }
189
- /**
190
- * Query for all matching elements.
191
- *
192
- * @see https://pptr.dev/api/puppeteer.frame.__
193
- */
194
- async $$(selector) {
195
- const results = await this.rpc('$$', [selector]);
196
- return results.map((r) => this.createElementHandle(r.id));
197
- }
198
- /**
199
- * Wait for a selector to appear.
200
- *
201
- * @see https://pptr.dev/api/puppeteer.frame.waitforselector
202
- */
203
- async waitForSelector(selector, options) {
204
- const result = await this.rpc('waitForSelector', [selector, options]);
205
- if (!result)
206
- return null;
207
- return this.createElementHandle(result.id);
208
- }
209
- /**
210
- * Click on an element.
211
- *
212
- * @see https://pptr.dev/api/puppeteer.frame.click
213
- */
214
- async click(selector, options) {
215
- await this.rpc('click', [selector, options]);
216
- }
217
- /**
218
- * Type text into an element.
219
- *
220
- * @see https://pptr.dev/api/puppeteer.frame.type
221
- */
222
- async type(selector, text, options) {
223
- await this.rpc('type', [selector, text, options]);
224
- }
225
- /**
226
- * Focus on an element.
227
- *
228
- * @see https://pptr.dev/api/puppeteer.frame.focus
229
- */
230
- async focus(selector) {
231
- await this.rpc('focus', [selector]);
232
- }
233
- /**
234
- * Hover over an element.
235
- *
236
- * @see https://pptr.dev/api/puppeteer.frame.hover
237
- */
238
- async hover(selector) {
239
- await this.rpc('hover', [selector]);
240
- }
241
- /**
242
- * Select options in a <select> element.
243
- *
244
- * @see https://pptr.dev/api/puppeteer.frame.select
245
- */
246
- async select(selector, ...values) {
247
- return this.rpc('select', [selector, ...values]);
248
- }
249
- /**
250
- * Tap on an element.
251
- *
252
- * @see https://pptr.dev/api/puppeteer.frame.tap
253
- */
254
- async tap(selector) {
255
- await this.rpc('tap', [selector]);
256
- }
257
- /**
258
- * Evaluate JavaScript in the frame context.
259
- *
260
- * @see https://pptr.dev/api/puppeteer.frame.evaluate
261
- */
262
- async evaluate(pageFunction, ...args) {
263
- const _pageFunction = serializeFunctionSource(pageFunction);
264
- return this.rpc('evaluate', [_pageFunction, ...args]);
265
- }
266
- /**
267
- * Evaluate JavaScript on a selected element.
268
- *
269
- * @see https://pptr.dev/api/puppeteer.frame._eval
270
- */
271
- async $eval(selector, pageFunction, ...args) {
272
- const _pageFunction = serializeFunctionSource(pageFunction);
273
- return this.rpc('$eval', [selector, _pageFunction, ...args]);
274
- }
275
- /**
276
- * Evaluate JavaScript on all matching elements.
277
- *
278
- * @see https://pptr.dev/api/puppeteer.frame.__eval
279
- */
280
- async $$eval(selector, pageFunction, ...args) {
281
- const _pageFunction = serializeFunctionSource(pageFunction);
282
- return this.rpc('$$eval', [selector, _pageFunction, ...args]);
283
- }
284
- /**
285
- * Add a script tag to the frame.
286
- *
287
- * @see https://pptr.dev/api/puppeteer.frame.addscripttag
288
- */
289
- async addScriptTag(options) {
290
- const result = await this.rpc('addScriptTag', [options]);
291
- return this.createElementHandle(result.id);
292
- }
293
- /**
294
- * Add a style tag to the frame.
295
- *
296
- * @see https://pptr.dev/api/puppeteer.frame.addstyletag
297
- */
298
- async addStyleTag(options) {
299
- const result = await this.rpc('addStyleTag', [options]);
300
- return this.createElementHandle(result.id);
301
- }
302
- }