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