@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,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
- }