@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,776 +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, } from '../../../internal/transport.js';
8
- import { PuppeteerEventEmitter } from '../event-emitter.js';
9
- import { RemotePuppeteerAccessibility } from './accessibility.js';
10
- import { RemotePuppeteerMouse } from './mouse.js';
11
- import { RemotePuppeteerKeyboard } from './keyboard.js';
12
- import { RemotePuppeteerTouchscreen } from './touchscreen.js';
13
- import { RemotePuppeteerTracing } from './tracing.js';
14
- import { RemotePuppeteerFileChooser } from './file-chooser.js';
15
- /**
16
- * RemotePuppeteerPage - Remote Puppeteer Page API over RPC.
17
- *
18
- * @see https://pptr.dev/api/puppeteer.page
19
- */
20
- export class RemotePuppeteerPage extends PuppeteerEventEmitter {
21
- accessibility;
22
- mouse;
23
- keyboard;
24
- touchscreen;
25
- tracing;
26
- createElementHandle;
27
- createFrame;
28
- createLocator;
29
- createJSHandle;
30
- sendRpc;
31
- constructor(sendRpc, id, createElementHandle, createFrame, createLocator, createJSHandle) {
32
- super();
33
- this.sendRpc = sendRpc;
34
- this.createElementHandle = createElementHandle;
35
- this.createFrame = createFrame;
36
- this.createLocator = createLocator;
37
- this.createJSHandle = createJSHandle;
38
- this.accessibility = new RemotePuppeteerAccessibility(this.rpc.bind(this));
39
- this.mouse = new RemotePuppeteerMouse(this.rpc.bind(this));
40
- this.keyboard = new RemotePuppeteerKeyboard(this.rpc.bind(this));
41
- this.touchscreen = new RemotePuppeteerTouchscreen(this.rpc.bind(this));
42
- this.tracing = new RemotePuppeteerTracing(this.rpc.bind(this));
43
- this.id = id;
44
- }
45
- id;
46
- _isClosed = false;
47
- _defaultTimeout = 30000;
48
- _defaultNavigationTimeout = 30000;
49
- _isDragInterceptionEnabled = false;
50
- get isClosed() {
51
- return this._isClosed;
52
- }
53
- /**
54
- * Mark this page as closed (internal use by browser.close()).
55
- */
56
- markClosed() {
57
- this._isClosed = true;
58
- }
59
- rpc(method, args) {
60
- if (this._isClosed) {
61
- throw new Error('Page is closed');
62
- }
63
- return this.sendRpc(method, args);
64
- }
65
- /**
66
- * Close the page.
67
- * @see https://pptr.dev/api/puppeteer.page.close
68
- */
69
- async close() {
70
- await this.rpc('close', []);
71
- this._isClosed = true;
72
- }
73
- /**
74
- * Take a screenshot (returns base64 string or Buffer).
75
- * @see https://pptr.dev/api/puppeteer.page.screenshot
76
- */
77
- async screenshot(options) {
78
- const result = await this.rpc('screenshot', [options]);
79
- if (typeof result === 'string' && options?.encoding !== 'base64') {
80
- return Buffer.from(result, 'base64');
81
- }
82
- return result;
83
- }
84
- /**
85
- * Generate a PDF (returns base64 string or Buffer).
86
- * @see https://pptr.dev/api/puppeteer.page.pdf
87
- */
88
- async pdf(options) {
89
- const result = await this.rpc('pdf', [options]);
90
- return Buffer.from(result, 'base64');
91
- }
92
- /**
93
- * Get the main frame.
94
- * @see https://pptr.dev/api/puppeteer.page.mainframe
95
- */
96
- mainFrame() {
97
- return this.createFrame('main');
98
- }
99
- /**
100
- * Set the default navigation timeout.
101
- * @see https://pptr.dev/api/puppeteer.page.setdefaultnavigationtimeout
102
- */
103
- async setDefaultNavigationTimeout(timeout) {
104
- await this.sendRpc('setDefaultNavigationTimeout', [timeout]);
105
- this._defaultNavigationTimeout = timeout;
106
- }
107
- /**
108
- * Set the default timeout.
109
- * @see https://pptr.dev/api/puppeteer.page.setdefaulttimeout
110
- */
111
- async setDefaultTimeout(timeout) {
112
- await this.sendRpc('setDefaultTimeout', [timeout]);
113
- this._defaultTimeout = timeout;
114
- }
115
- /**
116
- * Get the default navigation timeout.
117
- */
118
- getDefaultNavigationTimeout() {
119
- return this._defaultNavigationTimeout;
120
- }
121
- /**
122
- * Get the default timeout.
123
- */
124
- getDefaultTimeout() {
125
- return this._defaultTimeout;
126
- }
127
- /**
128
- * Create a locator for the given selector.
129
- * @see https://pptr.dev/api/puppeteer.page.locator
130
- */
131
- locator(selector) {
132
- return this.createLocator(selector);
133
- }
134
- /**
135
- * Check if drag interception is enabled.
136
- * @see https://pptr.dev/api/puppeteer.page.isdraginterceptionenabled
137
- */
138
- isDragInterceptionEnabled() {
139
- return this._isDragInterceptionEnabled;
140
- }
141
- /**
142
- * Set drag interception.
143
- * @see https://pptr.dev/api/puppeteer.page.setdraginterception
144
- */
145
- async setDragInterception(enabled) {
146
- await this.rpc('setDragInterception', [enabled]);
147
- this._isDragInterceptionEnabled = enabled;
148
- }
149
- /**
150
- * Wait for a file chooser to appear.
151
- * @see https://pptr.dev/api/puppeteer.page.waitforfilechooser
152
- */
153
- async waitForFileChooser(options) {
154
- const result = await this.rpc('waitForFileChooser', [options]);
155
- return new RemotePuppeteerFileChooser(result.id, this.sendRpc, result.isMultiple);
156
- }
157
- /**
158
- * Wait for a device prompt (e.g., Bluetooth, USB).
159
- * @see https://pptr.dev/api/puppeteer.page.waitfordeviceprompt
160
- */
161
- async waitForDevicePrompt(options) {
162
- const result = await this.rpc('waitForDevicePrompt', [options]);
163
- return {
164
- devices: result.devices,
165
- select: async (deviceId) => {
166
- await this.sendRpc('devicePrompt.select', [result.promptId, deviceId]);
167
- },
168
- cancel: async () => {
169
- await this.sendRpc('devicePrompt.cancel', [result.promptId]);
170
- },
171
- };
172
- }
173
- /**
174
- * Navigate to a URL.
175
- * @returns The main resource response, or null if navigating to about:blank.
176
- *
177
- * @see https://pptr.dev/api/puppeteer.page.goto
178
- */
179
- async goto(url, options) {
180
- return this.rpc('goto', [url, options]);
181
- }
182
- /**
183
- * Reload the page.
184
- *
185
- * @see https://pptr.dev/api/puppeteer.page.reload
186
- */
187
- async reload(options) {
188
- return this.rpc('reload', [options]);
189
- }
190
- /**
191
- * Navigate back in history.
192
- *
193
- * @see https://pptr.dev/api/puppeteer.page.goback
194
- */
195
- async goBack(options) {
196
- return this.rpc('goBack', [options]);
197
- }
198
- /**
199
- * Navigate forward in history.
200
- *
201
- * @see https://pptr.dev/api/puppeteer.page.goforward
202
- */
203
- async goForward(options) {
204
- return this.rpc('goForward', [options]);
205
- }
206
- /**
207
- * Wait for navigation to complete.
208
- *
209
- * @see https://pptr.dev/api/puppeteer.page.waitfornavigation
210
- */
211
- async waitForNavigation(options) {
212
- return this.rpc('waitForNavigation', [options]);
213
- }
214
- /**
215
- * Get the page title.
216
- *
217
- * @see https://pptr.dev/api/puppeteer.page.title
218
- */
219
- async title() {
220
- return this.rpc('title', []);
221
- }
222
- /**
223
- * Get the current URL.
224
- *
225
- * @see https://pptr.dev/api/puppeteer.page.url
226
- */
227
- async url() {
228
- return this.rpc('url', []);
229
- }
230
- /**
231
- * Get the full HTML content.
232
- *
233
- * @see https://pptr.dev/api/puppeteer.page.content
234
- */
235
- async content() {
236
- return this.rpc('content', []);
237
- }
238
- /**
239
- * Set the page content.
240
- *
241
- * @see https://pptr.dev/api/puppeteer.page.setcontent
242
- */
243
- async setContent(html, options) {
244
- await this.rpc('setContent', [html, options]);
245
- }
246
- /**
247
- * Click on an element matching the selector.
248
- *
249
- * @see https://pptr.dev/api/puppeteer.page.click
250
- */
251
- async click(selector, options) {
252
- await this.rpc('click', [selector, options]);
253
- }
254
- /**
255
- * Type text into an element.
256
- *
257
- * @see https://pptr.dev/api/puppeteer.page.type
258
- */
259
- async type(selector, text, options) {
260
- await this.rpc('type', [selector, text, options]);
261
- }
262
- /**
263
- * Focus on an element.
264
- *
265
- * @see https://pptr.dev/api/puppeteer.page.focus
266
- */
267
- async focus(selector) {
268
- await this.rpc('focus', [selector]);
269
- }
270
- /**
271
- * Hover over an element.
272
- *
273
- * @see https://pptr.dev/api/puppeteer.page.hover
274
- */
275
- async hover(selector) {
276
- await this.rpc('hover', [selector]);
277
- }
278
- /**
279
- * Select options in a <select> element.
280
- *
281
- * @see https://pptr.dev/api/puppeteer.page.select
282
- */
283
- async select(selector, ...values) {
284
- return this.rpc('select', [selector, ...values]);
285
- }
286
- /**
287
- * Tap on an element (for touch devices).
288
- *
289
- * @see https://pptr.dev/api/puppeteer.page.tap
290
- */
291
- async tap(selector) {
292
- await this.rpc('tap', [selector]);
293
- }
294
- /**
295
- * Get the text content of an element matching the selector.
296
- */
297
- async textContent(selector) {
298
- return this.rpc('textContent', [selector]);
299
- }
300
- /**
301
- * Get the inner HTML of an element matching the selector.
302
- */
303
- async innerHTML(selector) {
304
- return this.rpc('innerHTML', [selector]);
305
- }
306
- /**
307
- * Wait for a selector to appear in the DOM.
308
- *
309
- * @see https://pptr.dev/api/puppeteer.page.waitforselector
310
- */
311
- async waitForSelector(selector, options) {
312
- const result = await this.rpc('waitForSelector', [selector, options]);
313
- if (!result)
314
- return null;
315
- return this.createElementHandle(result.id);
316
- }
317
- /**
318
- * Wait for a timeout.
319
- *
320
- * @remarks
321
- * Deprecated: Use `await new Promise(r => setTimeout(r, ms))` instead.
322
- *
323
- * @see https://pptr.dev/api/puppeteer.page.waitfortimeout
324
- */
325
- async waitForTimeout(milliseconds) {
326
- await this.rpc('waitForTimeout', [milliseconds]);
327
- }
328
- /**
329
- * Wait for a function to return true.
330
- *
331
- * @see https://pptr.dev/api/puppeteer.page.waitforfunction
332
- */
333
- async waitForFunction(pageFunction, options, ...args) {
334
- const _pageFunction = serializeFunctionSource(pageFunction);
335
- await this.rpc('waitForFunction', [_pageFunction, options, ...args]);
336
- }
337
- /**
338
- * Wait for network to be idle.
339
- *
340
- * @see https://pptr.dev/api/puppeteer.page.waitfornetworkidle
341
- */
342
- async waitForNetworkIdle(options) {
343
- await this.rpc('waitForNetworkIdle', [options]);
344
- }
345
- /**
346
- * Evaluate JavaScript in the page context.
347
- *
348
- * @see https://pptr.dev/api/puppeteer.page.evaluate
349
- */
350
- async evaluate(pageFunction, ...args) {
351
- const _pageFunction = serializeFunctionSource(pageFunction);
352
- return this.rpc('evaluate', [_pageFunction, ...args]);
353
- }
354
- /**
355
- * Evaluate JavaScript on a selected element.
356
- *
357
- * @see https://pptr.dev/api/puppeteer.page._eval
358
- */
359
- async $eval(selector, pageFunction, ...args) {
360
- const _pageFunction = serializeFunctionSource(pageFunction);
361
- return this.rpc('$eval', [selector, _pageFunction, ...args]);
362
- }
363
- /**
364
- * Evaluate JavaScript on all matching elements.
365
- *
366
- * @see https://pptr.dev/api/puppeteer.page.__eval
367
- */
368
- async $$eval(selector, pageFunction, ...args) {
369
- const _pageFunction = serializeFunctionSource(pageFunction);
370
- return this.rpc('$$eval', [selector, _pageFunction, ...args]);
371
- }
372
- /**
373
- * Evaluate handle (returns a JSHandle).
374
- *
375
- * @remarks
376
- * Note: Handles are not fully supported in RPC mode - use evaluate instead.
377
- *
378
- * @see https://pptr.dev/api/puppeteer.page.evaluatehandle
379
- */
380
- async evaluateHandle(pageFunction, ...args) {
381
- const _pageFunction = serializeFunctionSource(pageFunction);
382
- return this.rpc('evaluateHandle', [_pageFunction, ...args]);
383
- }
384
- /**
385
- * Query for a single element.
386
- *
387
- * @see https://pptr.dev/api/puppeteer.page._
388
- */
389
- async $(selector) {
390
- const result = await this.rpc('$', [selector]);
391
- if (!result)
392
- return null;
393
- return this.createElementHandle(result.id);
394
- }
395
- /**
396
- * Query for all matching elements.
397
- *
398
- * @see https://pptr.dev/api/puppeteer.page.__
399
- */
400
- async $$(selector) {
401
- const results = await this.rpc('$$', [selector]);
402
- return results.map((r) => this.createElementHandle(r.id));
403
- }
404
- /**
405
- * Evaluate XPath expression.
406
- *
407
- * @see https://pptr.dev/api/puppeteer.page._x
408
- */
409
- async $x(expression) {
410
- const results = await this.rpc('$x', [expression]);
411
- return results.map((r) => this.createElementHandle(r.id));
412
- }
413
- /**
414
- * Set the viewport size. Pass null to reset to default.
415
- *
416
- * @see https://pptr.dev/api/puppeteer.page.setviewport
417
- */
418
- async setViewport(viewport) {
419
- await this.rpc('setViewport', [viewport]);
420
- }
421
- /**
422
- * Get the current viewport.
423
- *
424
- * @see https://pptr.dev/api/puppeteer.page.viewport
425
- */
426
- async viewport() {
427
- return this.rpc('viewport', []);
428
- }
429
- /**
430
- * Emulate media type.
431
- *
432
- * @see https://pptr.dev/api/puppeteer.page.emulatemediatype
433
- */
434
- async emulateMediaType(type) {
435
- await this.rpc('emulateMediaType', [type]);
436
- }
437
- /**
438
- * Emulate media features.
439
- *
440
- * @see https://pptr.dev/api/puppeteer.page.emulatemediafeatures
441
- */
442
- async emulateMediaFeatures(features) {
443
- await this.rpc('emulateMediaFeatures', [features]);
444
- }
445
- /**
446
- * Emulate timezone.
447
- *
448
- * @see https://pptr.dev/api/puppeteer.page.emulatetimezone
449
- */
450
- async emulateTimezone(timezoneId) {
451
- await this.rpc('emulateTimezone', [timezoneId]);
452
- }
453
- /**
454
- * Emulate vision deficiency.
455
- *
456
- * @see https://pptr.dev/api/puppeteer.page.emulatevisiondeficiency
457
- */
458
- async emulateVisionDeficiency(type) {
459
- await this.rpc('emulateVisionDeficiency', [type]);
460
- }
461
- /**
462
- * Set geolocation.
463
- *
464
- * @see https://pptr.dev/api/puppeteer.page.setgeolocation
465
- */
466
- async setGeolocation(geolocation) {
467
- await this.rpc('setGeolocation', [geolocation]);
468
- }
469
- /**
470
- * Set user agent.
471
- *
472
- * @see https://pptr.dev/api/puppeteer.page.setuseragent
473
- */
474
- async setUserAgent(userAgent) {
475
- await this.rpc('setUserAgent', [userAgent]);
476
- }
477
- /**
478
- * Set extra HTTP headers.
479
- *
480
- * @see https://pptr.dev/api/puppeteer.page.setextrahttpheaders
481
- */
482
- async setExtraHTTPHeaders(headers) {
483
- await this.rpc('setExtraHTTPHeaders', [headers]);
484
- }
485
- /**
486
- * Get all cookies.
487
- *
488
- * @see https://pptr.dev/api/puppeteer.page.cookies
489
- */
490
- async cookies(...urls) {
491
- return this.rpc('cookies', [...urls]);
492
- }
493
- /**
494
- * Set cookies.
495
- *
496
- * @see https://pptr.dev/api/puppeteer.page.setcookie
497
- */
498
- async setCookie(...cookies) {
499
- await this.rpc('setCookie', [...cookies]);
500
- }
501
- /**
502
- * Delete cookies.
503
- *
504
- * @see https://pptr.dev/api/puppeteer.page.deletecookie
505
- */
506
- async deleteCookie(...cookies) {
507
- await this.rpc('deleteCookie', [...cookies]);
508
- }
509
- /**
510
- * Bring page to front.
511
- *
512
- * @see https://pptr.dev/api/puppeteer.page.bringtofront
513
- */
514
- async bringToFront() {
515
- await this.rpc('bringToFront', []);
516
- }
517
- /**
518
- * Create a CDP session.
519
- *
520
- * @remarks
521
- * Note: Returns a session identifier in RPC mode (not a live CDPSession).
522
- *
523
- * @see https://pptr.dev/api/puppeteer.page.createcdpsession
524
- */
525
- async createCDPSession() {
526
- return this.rpc('createCDPSession', []);
527
- }
528
- /**
529
- * Send a CDP command directly.
530
- */
531
- async sendCDP(method, params) {
532
- return this.rpc('sendCDP', [method, params]);
533
- }
534
- /**
535
- * Get metrics.
536
- *
537
- * @see https://pptr.dev/api/puppeteer.page.metrics
538
- */
539
- async metrics() {
540
- return this.rpc('metrics', []);
541
- }
542
- /**
543
- * Set JavaScript enabled/disabled.
544
- *
545
- * @see https://pptr.dev/api/puppeteer.page.setjavascriptenabled
546
- */
547
- async setJavaScriptEnabled(enabled) {
548
- await this.rpc('setJavaScriptEnabled', [enabled]);
549
- }
550
- /**
551
- * Set cache enabled/disabled.
552
- *
553
- * @see https://pptr.dev/api/puppeteer.page.setcacheenabled
554
- */
555
- async setCacheEnabled(enabled) {
556
- await this.rpc('setCacheEnabled', [enabled]);
557
- }
558
- /**
559
- * Set offline mode.
560
- *
561
- * @see https://pptr.dev/api/puppeteer.page.setofflinemode
562
- */
563
- async setOfflineMode(enabled) {
564
- await this.rpc('setOfflineMode', [enabled]);
565
- }
566
- /**
567
- * Emulate network conditions.
568
- *
569
- * @see https://pptr.dev/api/puppeteer.page.emulatenetworkconditions
570
- */
571
- async emulateNetworkConditions(conditions) {
572
- await this.rpc('emulateNetworkConditions', [conditions]);
573
- }
574
- /**
575
- * Add script tag.
576
- *
577
- * @see https://pptr.dev/api/puppeteer.page.addscripttag
578
- */
579
- async addScriptTag(options) {
580
- return this.rpc('addScriptTag', [options]);
581
- }
582
- /**
583
- * Add style tag.
584
- *
585
- * @see https://pptr.dev/api/puppeteer.page.addstyletag
586
- */
587
- async addStyleTag(options) {
588
- return this.rpc('addStyleTag', [options]);
589
- }
590
- /**
591
- * Set request interception enabled/disabled.
592
- *
593
- * @see https://pptr.dev/api/puppeteer.page.setrequestinterception
594
- */
595
- async setRequestInterception(enabled) {
596
- await this.rpc('setRequestInterception', [enabled]);
597
- }
598
- /**
599
- * Authenticate with HTTP auth.
600
- *
601
- * @see https://pptr.dev/api/puppeteer.page.authenticate
602
- */
603
- async authenticate(credentials) {
604
- await this.rpc('authenticate', [credentials]);
605
- }
606
- /**
607
- * Get all frames.
608
- *
609
- * @see https://pptr.dev/api/puppeteer.page.frames
610
- */
611
- async frames() {
612
- const results = await this.rpc('frames', []);
613
- return results.map((r) => this.createFrame(r.id));
614
- }
615
- /**
616
- * Wait for a frame to appear.
617
- *
618
- * @remarks
619
- * Note: Predicate functions are not supported in RPC mode. Use URL string instead.
620
- *
621
- * @see https://pptr.dev/api/puppeteer.page.waitforframe
622
- */
623
- async waitForFrame(urlOrPredicate, options) {
624
- const result = await this.rpc('waitForFrame', [urlOrPredicate, options]);
625
- return this.createFrame(result.id);
626
- }
627
- /**
628
- * Wait for a specific request.
629
- *
630
- * @remarks
631
- * Note: Predicate functions are not supported in RPC mode. Use URL string instead.
632
- *
633
- * @see https://pptr.dev/api/puppeteer.page.waitforrequest
634
- */
635
- async waitForRequest(urlOrPredicate, options) {
636
- return this.rpc('waitForRequest', [urlOrPredicate, options]);
637
- }
638
- /**
639
- * Wait for a specific response.
640
- *
641
- * @remarks
642
- * Note: Predicate functions are not supported in RPC mode. Use URL string instead.
643
- *
644
- * @see https://pptr.dev/api/puppeteer.page.waitforresponse
645
- */
646
- async waitForResponse(urlOrPredicate, options) {
647
- return this.rpc('waitForResponse', [urlOrPredicate, options]);
648
- }
649
- /**
650
- * Toggle bypassing Content-Security-Policy.
651
- *
652
- * @see https://pptr.dev/api/puppeteer.page.setbypasscsp
653
- */
654
- async setBypassCSP(enabled) {
655
- await this.rpc('setBypassCSP', [enabled]);
656
- }
657
- /**
658
- * Add a script to evaluate when a new document is created.
659
- *
660
- * @see https://pptr.dev/api/puppeteer.page.evaluateonnewdocument
661
- */
662
- async evaluateOnNewDocument(pageFunction, ...args) {
663
- const _pageFunction = serializeFunctionSource(pageFunction);
664
- return this.rpc('evaluateOnNewDocument', [_pageFunction, ...args]);
665
- }
666
- /**
667
- * Remove an injected script.
668
- *
669
- * @see https://pptr.dev/api/puppeteer.page.removescripttoevaluateonnewdocument
670
- */
671
- async removeScriptToEvaluateOnNewDocument(identifier) {
672
- await this.rpc('removeScriptToEvaluateOnNewDocument', [identifier]);
673
- }
674
- /**
675
- * Remove an exposed function.
676
- *
677
- * @see https://pptr.dev/api/puppeteer.page.removeexposedfunction
678
- */
679
- async removeExposedFunction(name) {
680
- await this.rpc('removeExposedFunction', [name]);
681
- }
682
- /**
683
- * Emulate a device (viewport + user agent).
684
- *
685
- * @see https://pptr.dev/api/puppeteer.page.emulate
686
- */
687
- async emulate(device) {
688
- await this.rpc('emulate', [device]);
689
- }
690
- /**
691
- * Emulate CPU throttling.
692
- *
693
- * @see https://pptr.dev/api/puppeteer.page.emulatecputhrottling
694
- */
695
- async emulateCPUThrottling(factor) {
696
- await this.rpc('emulateCPUThrottling', [factor]);
697
- }
698
- /**
699
- * Emulate idle state.
700
- *
701
- * @see https://pptr.dev/api/puppeteer.page.emulateidlestate
702
- */
703
- async emulateIdleState(overrides) {
704
- await this.rpc('emulateIdleState', [overrides]);
705
- }
706
- /**
707
- * Check if JavaScript is enabled.
708
- *
709
- * @see https://pptr.dev/api/puppeteer.page.isjavascriptenabled
710
- */
711
- async isJavaScriptEnabled() {
712
- return this.rpc('isJavaScriptEnabled', []);
713
- }
714
- /**
715
- * Check if service worker bypass is enabled.
716
- *
717
- * @see https://pptr.dev/api/puppeteer.page.isserviceworkerbypassed
718
- */
719
- async isServiceWorkerBypassed() {
720
- return this.rpc('isServiceWorkerBypassed', []);
721
- }
722
- /**
723
- * Set service worker bypass.
724
- *
725
- * @see https://pptr.dev/api/puppeteer.page.setbypassserviceworker
726
- */
727
- async setBypassServiceWorker(bypass) {
728
- await this.rpc('setBypassServiceWorker', [bypass]);
729
- }
730
- /**
731
- * Get the target for this page.
732
- *
733
- * @see https://pptr.dev/api/puppeteer.page.target
734
- */
735
- async target() {
736
- return this.rpc('target', []);
737
- }
738
- /**
739
- * Get all web workers for this page.
740
- *
741
- * @see https://pptr.dev/api/puppeteer.page.workers
742
- */
743
- async workers() {
744
- return this.rpc('workers', []);
745
- }
746
- /**
747
- * Get the window ID.
748
- */
749
- async windowId() {
750
- return this.rpc('windowId', []);
751
- }
752
- /**
753
- * Resize the page.
754
- */
755
- async resize(options) {
756
- await this.rpc('resize', [options]);
757
- }
758
- /**
759
- * Query all objects of a given prototype.
760
- *
761
- * @see https://pptr.dev/api/puppeteer.page.queryobjects
762
- */
763
- async queryObjects(prototypeHandle) {
764
- const _prototypeHandle = extractHandleId(prototypeHandle);
765
- const result = await this.rpc('queryObjects', [_prototypeHandle]);
766
- return this.createElementHandle(result.id);
767
- }
768
- /**
769
- * Open DevTools. Only works in headful mode.
770
- *
771
- * @see https://pptr.dev/api/puppeteer.page.opendevtools
772
- */
773
- async openDevTools(options) {
774
- await this.rpc('openDevTools', [options]);
775
- }
776
- }