appium-uiautomator2-driver 2.29.10 → 2.30.0

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 (135) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/build/index.d.ts +4 -0
  3. package/build/index.d.ts.map +1 -0
  4. package/build/index.js +8 -16
  5. package/build/index.js.map +1 -0
  6. package/build/lib/commands/actions.d.ts +2 -0
  7. package/build/lib/commands/actions.d.ts.map +1 -0
  8. package/build/lib/commands/actions.js +67 -65
  9. package/build/lib/commands/actions.js.map +1 -1
  10. package/build/lib/commands/alert.d.ts +2 -0
  11. package/build/lib/commands/alert.d.ts.map +1 -0
  12. package/build/lib/commands/alert.js +28 -29
  13. package/build/lib/commands/alert.js.map +1 -1
  14. package/build/lib/commands/app-strings.d.ts +3 -0
  15. package/build/lib/commands/app-strings.d.ts.map +1 -0
  16. package/build/lib/commands/app-strings.js +86 -58
  17. package/build/lib/commands/app-strings.js.map +1 -1
  18. package/build/lib/commands/battery.d.ts +2 -0
  19. package/build/lib/commands/battery.d.ts.map +1 -0
  20. package/build/lib/commands/battery.js +26 -18
  21. package/build/lib/commands/battery.js.map +1 -1
  22. package/build/lib/commands/element.d.ts +2 -0
  23. package/build/lib/commands/element.d.ts.map +1 -0
  24. package/build/lib/commands/element.js +140 -162
  25. package/build/lib/commands/element.js.map +1 -1
  26. package/build/lib/commands/find.d.ts +2 -0
  27. package/build/lib/commands/find.d.ts.map +1 -0
  28. package/build/lib/commands/find.js +39 -27
  29. package/build/lib/commands/find.js.map +1 -1
  30. package/build/lib/commands/general.d.ts +4 -0
  31. package/build/lib/commands/general.d.ts.map +1 -0
  32. package/build/lib/commands/general.js +217 -216
  33. package/build/lib/commands/general.js.map +1 -1
  34. package/build/lib/commands/gestures.d.ts +2 -0
  35. package/build/lib/commands/gestures.d.ts.map +1 -0
  36. package/build/lib/commands/gestures.js +206 -194
  37. package/build/lib/commands/gestures.js.map +1 -1
  38. package/build/lib/commands/index.d.ts +2 -0
  39. package/build/lib/commands/index.d.ts.map +1 -0
  40. package/build/lib/commands/index.js +13 -23
  41. package/build/lib/commands/index.js.map +1 -1
  42. package/build/lib/commands/mixins.d.ts +84 -0
  43. package/build/lib/commands/mixins.d.ts.map +1 -0
  44. package/build/lib/commands/mixins.js +23 -0
  45. package/build/lib/commands/mixins.js.map +1 -0
  46. package/build/lib/commands/screenshot.d.ts +2 -0
  47. package/build/lib/commands/screenshot.d.ts.map +1 -0
  48. package/build/lib/commands/screenshot.js +77 -63
  49. package/build/lib/commands/screenshot.js.map +1 -1
  50. package/build/lib/commands/touch.d.ts +2 -0
  51. package/build/lib/commands/touch.d.ts.map +1 -0
  52. package/build/lib/commands/touch.js +48 -39
  53. package/build/lib/commands/touch.js.map +1 -1
  54. package/build/lib/commands/types.d.ts +452 -0
  55. package/build/lib/commands/types.d.ts.map +1 -0
  56. package/build/lib/commands/types.js +3 -0
  57. package/build/lib/commands/types.js.map +1 -0
  58. package/build/lib/commands/viewport.d.ts +2 -0
  59. package/build/lib/commands/viewport.d.ts.map +1 -0
  60. package/build/lib/commands/viewport.js +37 -37
  61. package/build/lib/commands/viewport.js.map +1 -1
  62. package/build/lib/constraints.d.ts +334 -0
  63. package/build/lib/constraints.d.ts.map +1 -0
  64. package/build/lib/constraints.js +51 -0
  65. package/build/lib/constraints.js.map +1 -0
  66. package/build/lib/css-converter.d.ts +45 -0
  67. package/build/lib/css-converter.d.ts.map +1 -0
  68. package/build/lib/css-converter.js +272 -176
  69. package/build/lib/css-converter.js.map +1 -1
  70. package/build/lib/driver.d.ts +912 -0
  71. package/build/lib/driver.d.ts.map +1 -0
  72. package/build/lib/driver.js +738 -483
  73. package/build/lib/driver.js.map +1 -1
  74. package/build/lib/execute-method-map.d.ts +477 -0
  75. package/build/lib/execute-method-map.d.ts.map +1 -0
  76. package/build/lib/execute-method-map.js +542 -0
  77. package/build/lib/execute-method-map.js.map +1 -0
  78. package/build/lib/extensions.d.ts +3 -0
  79. package/build/lib/extensions.d.ts.map +1 -0
  80. package/build/lib/extensions.js +3 -7
  81. package/build/lib/extensions.js.map +1 -1
  82. package/build/lib/helpers.d.ts +7 -0
  83. package/build/lib/helpers.d.ts.map +1 -0
  84. package/build/lib/helpers.js +36 -30
  85. package/build/lib/helpers.js.map +1 -1
  86. package/build/lib/logger.d.ts +3 -0
  87. package/build/lib/logger.d.ts.map +1 -0
  88. package/build/lib/logger.js +5 -11
  89. package/build/lib/logger.js.map +1 -1
  90. package/build/lib/method-map.d.ts +389 -0
  91. package/build/lib/method-map.d.ts.map +1 -0
  92. package/build/lib/method-map.js +11 -18
  93. package/build/lib/method-map.js.map +1 -1
  94. package/build/lib/types.d.ts +45 -0
  95. package/build/lib/types.d.ts.map +1 -0
  96. package/build/lib/types.js +3 -0
  97. package/build/lib/types.js.map +1 -0
  98. package/build/lib/uiautomator2.d.ts +45 -0
  99. package/build/lib/uiautomator2.d.ts.map +1 -0
  100. package/build/lib/uiautomator2.js +334 -297
  101. package/build/lib/uiautomator2.js.map +1 -1
  102. package/build/lib/utils.d.ts +10 -0
  103. package/build/lib/utils.d.ts.map +1 -0
  104. package/build/lib/utils.js +23 -16
  105. package/build/lib/utils.js.map +1 -1
  106. package/build/tsconfig.tsbuildinfo +1 -0
  107. package/index.js +5 -3
  108. package/lib/commands/actions.js +115 -101
  109. package/lib/commands/alert.js +36 -44
  110. package/lib/commands/app-strings.js +79 -58
  111. package/lib/commands/battery.js +27 -28
  112. package/lib/commands/element.js +231 -134
  113. package/lib/commands/find.js +40 -21
  114. package/lib/commands/general.js +271 -336
  115. package/lib/commands/gestures.js +252 -366
  116. package/lib/commands/index.js +11 -31
  117. package/lib/commands/mixins.ts +167 -0
  118. package/lib/commands/screenshot.js +80 -76
  119. package/lib/commands/touch.js +64 -31
  120. package/lib/commands/types.ts +473 -0
  121. package/lib/commands/viewport.js +43 -31
  122. package/lib/constraints.ts +53 -0
  123. package/lib/css-converter.js +9 -1
  124. package/lib/{driver.js → driver.ts} +383 -225
  125. package/lib/execute-method-map.ts +573 -0
  126. package/lib/method-map.ts +11 -0
  127. package/lib/types.ts +59 -0
  128. package/lib/uiautomator2.js +21 -2
  129. package/lib/utils.js +2 -2
  130. package/npm-shrinkwrap.json +396 -528
  131. package/package.json +96 -70
  132. package/build/lib/desired-caps.js +0 -72
  133. package/build/lib/desired-caps.js.map +0 -1
  134. package/lib/desired-caps.js +0 -70
  135. package/lib/method-map.js +0 -11
@@ -0,0 +1,912 @@
1
+ import type { DriverData, ExternalDriver, InitialOpts, RouteMatcher, SingularSessionData, StringRecord } from '@appium/types';
2
+ import AndroidDriver from 'appium-android-driver';
3
+ import { mjpeg } from 'appium/support';
4
+ import { type Uiautomator2Constraints } from './constraints';
5
+ import type { Uiautomator2Settings, Uiautomator2CreateResult, Uiautomator2DeviceDetails, Uiautomator2DeviceInfo, Uiautomator2DriverCaps, Uiautomator2DriverOpts, Uiautomator2SessionCaps, Uiautomator2StartSessionOpts, W3CUiautomator2DriverCaps } from './types';
6
+ import { UiAutomator2Server } from './uiautomator2';
7
+ declare class AndroidUiautomator2Driver extends AndroidDriver<Uiautomator2Settings, Uiautomator2CreateResult> implements ExternalDriver<Uiautomator2Constraints, string, StringRecord, Uiautomator2Settings, Uiautomator2CreateResult> {
8
+ static newMethodMap: {
9
+ readonly '/session/:sessionId/appium/device/get_clipboard': {
10
+ readonly POST: {
11
+ readonly command: "getClipboard";
12
+ readonly payloadParams: {
13
+ readonly optional: readonly ["contentType"];
14
+ };
15
+ };
16
+ };
17
+ readonly '/session/:sessionId/timeouts/implicit_wait': {
18
+ readonly POST: {
19
+ readonly command: "implicitWait";
20
+ readonly payloadParams: {
21
+ readonly required: readonly ["ms"];
22
+ };
23
+ };
24
+ };
25
+ readonly '/session/:sessionId/ime/available_engines': {
26
+ readonly GET: {
27
+ readonly command: "availableIMEEngines";
28
+ };
29
+ };
30
+ readonly '/session/:sessionId/ime/active_engine': {
31
+ readonly GET: {
32
+ readonly command: "getActiveIMEEngine";
33
+ };
34
+ };
35
+ readonly '/session/:sessionId/ime/activated': {
36
+ readonly GET: {
37
+ readonly command: "isIMEActivated";
38
+ };
39
+ };
40
+ readonly '/session/:sessionId/ime/deactivate': {
41
+ readonly POST: {
42
+ readonly command: "deactivateIMEEngine";
43
+ };
44
+ };
45
+ readonly '/session/:sessionId/ime/activate': {
46
+ readonly POST: {
47
+ readonly command: "activateIMEEngine";
48
+ readonly payloadParams: {
49
+ readonly required: readonly ["engine"];
50
+ };
51
+ };
52
+ };
53
+ readonly '/session/:sessionId/window/:windowhandle/size': {
54
+ readonly GET: {
55
+ readonly command: "getWindowSize";
56
+ };
57
+ };
58
+ readonly '/session/:sessionId/keys': {
59
+ readonly POST: {
60
+ readonly command: "keys";
61
+ readonly payloadParams: {
62
+ readonly required: readonly ["value"];
63
+ };
64
+ };
65
+ };
66
+ readonly '/session/:sessionId/element/:elementId/location': {
67
+ readonly GET: {
68
+ readonly command: "getLocation";
69
+ };
70
+ };
71
+ readonly '/session/:sessionId/element/:elementId/location_in_view': {
72
+ readonly GET: {
73
+ readonly command: "getLocationInView";
74
+ };
75
+ };
76
+ readonly '/session/:sessionId/element/:elementId/size': {
77
+ readonly GET: {
78
+ readonly command: "getSize";
79
+ };
80
+ };
81
+ readonly '/session/:sessionId/touch/click': {
82
+ readonly POST: {
83
+ readonly command: "click";
84
+ readonly payloadParams: {
85
+ readonly required: readonly ["element"];
86
+ };
87
+ };
88
+ };
89
+ readonly '/session/:sessionId/touch/down': {
90
+ readonly POST: {
91
+ readonly command: "touchDown";
92
+ readonly payloadParams: {
93
+ readonly required: readonly ["x", "y"];
94
+ };
95
+ };
96
+ };
97
+ readonly '/session/:sessionId/touch/up': {
98
+ readonly POST: {
99
+ readonly command: "touchUp";
100
+ readonly payloadParams: {
101
+ readonly required: readonly ["x", "y"];
102
+ };
103
+ };
104
+ };
105
+ readonly '/session/:sessionId/touch/move': {
106
+ readonly POST: {
107
+ readonly command: "touchMove";
108
+ readonly payloadParams: {
109
+ readonly required: readonly ["x", "y"];
110
+ };
111
+ };
112
+ };
113
+ readonly '/session/:sessionId/touch/longclick': {
114
+ readonly POST: {
115
+ readonly command: "touchLongClick";
116
+ readonly payloadParams: {
117
+ readonly required: readonly ["elements"];
118
+ };
119
+ };
120
+ };
121
+ readonly '/session/:sessionId/touch/flick': {
122
+ readonly POST: {
123
+ readonly command: "flick";
124
+ readonly payloadParams: {
125
+ readonly optional: readonly ["element", "xspeed", "yspeed", "xoffset", "yoffset", "speed"];
126
+ };
127
+ };
128
+ };
129
+ readonly '/session/:sessionId/touch/perform': {
130
+ readonly POST: {
131
+ readonly command: "performTouch";
132
+ readonly payloadParams: {
133
+ readonly wrap: "actions";
134
+ readonly required: readonly ["actions"];
135
+ };
136
+ };
137
+ };
138
+ readonly '/session/:sessionId/touch/multi/perform': {
139
+ readonly POST: {
140
+ readonly command: "performMultiAction";
141
+ readonly payloadParams: {
142
+ readonly required: readonly ["actions"];
143
+ readonly optional: readonly ["elementId"];
144
+ };
145
+ };
146
+ };
147
+ readonly '/session/:sessionId/appium/device/lock': {
148
+ readonly POST: {
149
+ readonly command: "lock";
150
+ readonly payloadParams: {
151
+ readonly optional: readonly ["seconds"];
152
+ };
153
+ };
154
+ };
155
+ readonly '/session/:sessionId/appium/device/unlock': {
156
+ readonly POST: {
157
+ readonly command: "unlock";
158
+ };
159
+ };
160
+ readonly '/session/:sessionId/appium/device/is_locked': {
161
+ readonly POST: {
162
+ readonly command: "isLocked";
163
+ };
164
+ };
165
+ readonly '/session/:sessionId/appium/start_recording_screen': {
166
+ readonly POST: {
167
+ readonly command: "startRecordingScreen";
168
+ readonly payloadParams: {
169
+ readonly optional: readonly ["options"];
170
+ };
171
+ };
172
+ };
173
+ readonly '/session/:sessionId/appium/stop_recording_screen': {
174
+ readonly POST: {
175
+ readonly command: "stopRecordingScreen";
176
+ readonly payloadParams: {
177
+ readonly optional: readonly ["options"];
178
+ };
179
+ };
180
+ };
181
+ readonly '/session/:sessionId/appium/performanceData/types': {
182
+ readonly POST: {
183
+ readonly command: "getPerformanceDataTypes";
184
+ };
185
+ };
186
+ readonly '/session/:sessionId/appium/getPerformanceData': {
187
+ readonly POST: {
188
+ readonly command: "getPerformanceData";
189
+ readonly payloadParams: {
190
+ readonly required: readonly ["packageName", "dataType"];
191
+ readonly optional: readonly ["dataReadTimeout"];
192
+ };
193
+ };
194
+ };
195
+ readonly '/session/:sessionId/appium/device/press_keycode': {
196
+ readonly POST: {
197
+ readonly command: "pressKeyCode";
198
+ readonly payloadParams: {
199
+ readonly required: readonly ["keycode"];
200
+ readonly optional: readonly ["metastate", "flags"];
201
+ };
202
+ };
203
+ };
204
+ readonly '/session/:sessionId/appium/device/long_press_keycode': {
205
+ readonly POST: {
206
+ readonly command: "longPressKeyCode";
207
+ readonly payloadParams: {
208
+ readonly required: readonly ["keycode"];
209
+ readonly optional: readonly ["metastate", "flags"];
210
+ };
211
+ };
212
+ };
213
+ readonly '/session/:sessionId/appium/device/finger_print': {
214
+ readonly POST: {
215
+ readonly command: "fingerprint";
216
+ readonly payloadParams: {
217
+ readonly required: readonly ["fingerprintId"];
218
+ };
219
+ };
220
+ };
221
+ readonly '/session/:sessionId/appium/device/send_sms': {
222
+ readonly POST: {
223
+ readonly command: "sendSMS";
224
+ readonly payloadParams: {
225
+ readonly required: readonly ["phoneNumber", "message"];
226
+ };
227
+ };
228
+ };
229
+ readonly '/session/:sessionId/appium/device/gsm_call': {
230
+ readonly POST: {
231
+ readonly command: "gsmCall";
232
+ readonly payloadParams: {
233
+ readonly required: readonly ["phoneNumber", "action"];
234
+ };
235
+ };
236
+ };
237
+ readonly '/session/:sessionId/appium/device/gsm_signal': {
238
+ readonly POST: {
239
+ readonly command: "gsmSignal";
240
+ readonly payloadParams: {
241
+ readonly required: readonly ["signalStrength"];
242
+ };
243
+ };
244
+ };
245
+ readonly '/session/:sessionId/appium/device/gsm_voice': {
246
+ readonly POST: {
247
+ readonly command: "gsmVoice";
248
+ readonly payloadParams: {
249
+ readonly required: readonly ["state"];
250
+ };
251
+ };
252
+ };
253
+ readonly '/session/:sessionId/appium/device/power_capacity': {
254
+ readonly POST: {
255
+ readonly command: "powerCapacity";
256
+ readonly payloadParams: {
257
+ readonly required: readonly ["percent"];
258
+ };
259
+ };
260
+ };
261
+ readonly '/session/:sessionId/appium/device/power_ac': {
262
+ readonly POST: {
263
+ readonly command: "powerAC";
264
+ readonly payloadParams: {
265
+ readonly required: readonly ["state"];
266
+ };
267
+ };
268
+ };
269
+ readonly '/session/:sessionId/appium/device/network_speed': {
270
+ readonly POST: {
271
+ readonly command: "networkSpeed";
272
+ readonly payloadParams: {
273
+ readonly required: readonly ["netspeed"];
274
+ };
275
+ };
276
+ };
277
+ readonly '/session/:sessionId/appium/device/keyevent': {
278
+ readonly POST: {
279
+ readonly command: "keyevent";
280
+ readonly payloadParams: {
281
+ readonly required: readonly ["keycode"];
282
+ readonly optional: readonly ["metastate"];
283
+ };
284
+ };
285
+ };
286
+ readonly '/session/:sessionId/appium/device/current_activity': {
287
+ readonly GET: {
288
+ readonly command: "getCurrentActivity";
289
+ };
290
+ };
291
+ readonly '/session/:sessionId/appium/device/current_package': {
292
+ readonly GET: {
293
+ readonly command: "getCurrentPackage";
294
+ };
295
+ };
296
+ readonly '/session/:sessionId/appium/device/app_state': {
297
+ readonly POST: {
298
+ readonly command: "queryAppState";
299
+ readonly payloadParams: {
300
+ readonly required: readonly [readonly ["appId"], readonly ["bundleId"]];
301
+ };
302
+ };
303
+ };
304
+ readonly '/session/:sessionId/appium/device/toggle_airplane_mode': {
305
+ readonly POST: {
306
+ readonly command: "toggleFlightMode";
307
+ };
308
+ };
309
+ readonly '/session/:sessionId/appium/device/toggle_data': {
310
+ readonly POST: {
311
+ readonly command: "toggleData";
312
+ };
313
+ };
314
+ readonly '/session/:sessionId/appium/device/toggle_wifi': {
315
+ readonly POST: {
316
+ readonly command: "toggleWiFi";
317
+ };
318
+ };
319
+ readonly '/session/:sessionId/appium/device/toggle_location_services': {
320
+ readonly POST: {
321
+ readonly command: "toggleLocationServices";
322
+ };
323
+ };
324
+ readonly '/session/:sessionId/appium/device/open_notifications': {
325
+ readonly POST: {
326
+ readonly command: "openNotifications";
327
+ };
328
+ };
329
+ readonly '/session/:sessionId/appium/device/start_activity': {
330
+ readonly POST: {
331
+ readonly command: "startActivity";
332
+ readonly payloadParams: {
333
+ readonly required: readonly ["appPackage", "appActivity"];
334
+ readonly optional: readonly ["appWaitPackage", "appWaitActivity", "intentAction", "intentCategory", "intentFlags", "optionalIntentArguments", "dontStopAppOnReset"];
335
+ };
336
+ };
337
+ };
338
+ readonly '/session/:sessionId/appium/device/system_bars': {
339
+ readonly GET: {
340
+ readonly command: "getSystemBars";
341
+ };
342
+ };
343
+ readonly '/session/:sessionId/appium/device/display_density': {
344
+ readonly GET: {
345
+ readonly command: "getDisplayDensity";
346
+ };
347
+ };
348
+ readonly '/session/:sessionId/appium/app/launch': {
349
+ readonly POST: {
350
+ readonly command: "launchApp";
351
+ };
352
+ };
353
+ readonly '/session/:sessionId/appium/app/close': {
354
+ readonly POST: {
355
+ readonly command: "closeApp";
356
+ };
357
+ };
358
+ readonly '/session/:sessionId/appium/app/reset': {
359
+ readonly POST: {
360
+ readonly command: "reset";
361
+ };
362
+ };
363
+ readonly '/session/:sessionId/appium/app/background': {
364
+ readonly POST: {
365
+ readonly command: "background";
366
+ readonly payloadParams: {
367
+ readonly required: readonly ["seconds"];
368
+ };
369
+ };
370
+ };
371
+ readonly '/session/:sessionId/appium/app/strings': {
372
+ readonly POST: {
373
+ readonly command: "getStrings";
374
+ readonly payloadParams: {
375
+ readonly optional: readonly ["language", "stringFile"];
376
+ };
377
+ };
378
+ };
379
+ readonly '/session/:sessionId/appium/element/:elementId/value': {
380
+ readonly POST: {
381
+ readonly command: "setValueImmediate";
382
+ readonly payloadParams: {
383
+ readonly required: readonly ["text"];
384
+ };
385
+ };
386
+ };
387
+ readonly '/session/:sessionId/appium/element/:elementId/replace_value': {
388
+ readonly POST: {
389
+ readonly command: "replaceValue";
390
+ readonly payloadParams: {
391
+ readonly required: readonly ["text"];
392
+ };
393
+ };
394
+ };
395
+ };
396
+ static executeMethodMap: {
397
+ readonly 'mobile: shell': {
398
+ readonly command: "mobileShell";
399
+ readonly params: {
400
+ readonly required: readonly ["command"];
401
+ readonly optional: readonly ["args", "timeout", "includeStderr"];
402
+ };
403
+ };
404
+ readonly 'mobile: execEmuConsoleCommand': {
405
+ readonly command: "mobileExecEmuConsoleCommand";
406
+ readonly params: {
407
+ readonly required: readonly ["command"];
408
+ readonly optional: readonly ["execTimeout", "connTimeout", "initTimeout"];
409
+ };
410
+ };
411
+ readonly 'mobile: dragGesture': {
412
+ readonly command: "mobileDragGesture";
413
+ readonly params: {
414
+ readonly optional: readonly ["elementId", "startX", "startY", "endX", "endY", "speed"];
415
+ };
416
+ };
417
+ readonly 'mobile: flingGesture': {
418
+ readonly command: "mobileFlingGesture";
419
+ readonly params: {
420
+ readonly required: readonly ["direction"];
421
+ readonly optional: readonly ["elementId", "left", "top", "width", "height", "speed"];
422
+ };
423
+ };
424
+ readonly 'mobile: doubleClickGesture': {
425
+ readonly command: "mobileDoubleClickGesture";
426
+ readonly params: {
427
+ readonly optional: readonly ["elementId", "x", "y"];
428
+ };
429
+ };
430
+ readonly 'mobile: clickGesture': {
431
+ readonly command: "mobileClickGesture";
432
+ readonly params: {
433
+ readonly optional: readonly ["elementId", "x", "y"];
434
+ };
435
+ };
436
+ readonly 'mobile: longClickGesture': {
437
+ readonly command: "mobileLongClickGesture";
438
+ readonly params: {
439
+ readonly optional: readonly ["elementId", "x", "y", "duration"];
440
+ };
441
+ };
442
+ readonly 'mobile: pinchCloseGesture': {
443
+ readonly command: "mobilePinchCloseGesture";
444
+ readonly params: {
445
+ readonly required: readonly ["percent"];
446
+ readonly optional: readonly ["elementId", "left", "top", "width", "height", "speed"];
447
+ };
448
+ };
449
+ readonly 'mobile: pinchOpenGesture': {
450
+ readonly command: "mobilePinchOpenGesture";
451
+ readonly params: {
452
+ readonly required: readonly ["percent"];
453
+ readonly optional: readonly ["elementId", "left", "top", "width", "height", "speed"];
454
+ };
455
+ };
456
+ readonly 'mobile: swipeGesture': {
457
+ readonly command: "mobileSwipeGesture";
458
+ readonly params: {
459
+ readonly required: readonly ["direction", "percent"];
460
+ readonly optional: readonly ["elementId", "left", "top", "width", "height", "speed"];
461
+ };
462
+ };
463
+ readonly 'mobile: scrollGesture': {
464
+ readonly command: "mobileScrollGesture";
465
+ readonly params: {
466
+ readonly required: readonly ["direction", "percent"];
467
+ readonly optional: readonly ["elementId", "left", "top", "width", "height", "speed"];
468
+ };
469
+ };
470
+ readonly 'mobile: scrollBackTo': {
471
+ readonly command: "mobileScrollBackTo";
472
+ readonly params: {
473
+ readonly required: readonly ["elementId", "elementToId"];
474
+ };
475
+ };
476
+ readonly 'mobile: scroll': {
477
+ readonly command: "mobileScroll";
478
+ readonly params: {
479
+ readonly required: readonly ["strategy", "selector"];
480
+ readonly optional: readonly ["elementId", "maxSwipes", "element"];
481
+ };
482
+ };
483
+ readonly 'mobile: viewportScreenshot': {
484
+ readonly command: "mobileViewportScreenshot";
485
+ };
486
+ readonly 'mobile: viewportRect': {
487
+ readonly command: "mobileViewPortRect";
488
+ };
489
+ readonly 'mobile: deepLink': {
490
+ readonly command: "mobileDeepLink";
491
+ readonly params: {
492
+ readonly required: readonly ["url", "package"];
493
+ readonly optional: readonly ["waitForLaunch"];
494
+ };
495
+ };
496
+ readonly 'mobile: startLogsBroadcast': {
497
+ readonly command: "mobileStartLogsBroadcast";
498
+ };
499
+ readonly 'mobile: stopLogsBroadcast': {
500
+ readonly command: "mobileStopLogsBroadcast";
501
+ };
502
+ readonly 'mobile: acceptAlert': {
503
+ readonly command: "mobileAcceptAlert";
504
+ readonly params: {
505
+ readonly optional: readonly ["buttonLabel"];
506
+ };
507
+ };
508
+ readonly 'mobile: dismissAlert': {
509
+ readonly command: "mobileDismissAlert";
510
+ readonly params: {
511
+ readonly optional: readonly ["buttonLabel"];
512
+ };
513
+ };
514
+ readonly 'mobile: batteryInfo': {
515
+ readonly command: "mobileGetBatteryInfo";
516
+ };
517
+ readonly 'mobile: deviceInfo': {
518
+ readonly command: "mobileGetDeviceInfo";
519
+ };
520
+ readonly 'mobile: getDeviceTime': {
521
+ readonly command: "mobileGetDeviceTime";
522
+ readonly params: {
523
+ readonly optional: readonly ["format"];
524
+ };
525
+ };
526
+ readonly 'mobile: changePermissions': {
527
+ readonly command: "mobileChangePermissions";
528
+ readonly params: {
529
+ readonly required: readonly ["permissions"];
530
+ readonly optional: readonly ["appPackage", "action", "target"];
531
+ };
532
+ };
533
+ readonly 'mobile: getPermissions': {
534
+ readonly command: "mobileGetPermissions";
535
+ readonly params: {
536
+ readonly optional: readonly ["type", "appPackage"];
537
+ };
538
+ };
539
+ readonly 'mobile: performEditorAction': {
540
+ readonly command: "mobilePerformEditorAction";
541
+ readonly params: {
542
+ readonly required: readonly ["action"];
543
+ };
544
+ };
545
+ readonly 'mobile: startScreenStreaming': {
546
+ readonly command: "mobileStartScreenStreaming";
547
+ readonly params: {
548
+ readonly optional: readonly ["width", "height", "bitrate", "host", "pathname", "tcpPort", "port", "quality", "considerRotation", "logPipelineDetails"];
549
+ };
550
+ };
551
+ readonly 'mobile: stopScreenStreaming': {
552
+ readonly command: "mobileStopScreenStreaming";
553
+ };
554
+ readonly 'mobile: getNotifications': {
555
+ readonly command: "mobileGetNotifications";
556
+ };
557
+ readonly 'mobile: openNotifications': {
558
+ readonly command: "openNotifications";
559
+ };
560
+ readonly 'mobile: listSms': {
561
+ readonly command: "mobileListSms";
562
+ readonly params: {
563
+ readonly optional: readonly ["max"];
564
+ };
565
+ };
566
+ readonly 'mobile: type': {
567
+ readonly command: "mobileType";
568
+ readonly params: {
569
+ readonly required: readonly ["text"];
570
+ };
571
+ };
572
+ readonly 'mobile: replaceElementValue': {
573
+ readonly command: "mobileReplaceElementValue";
574
+ readonly params: {
575
+ readonly required: readonly ["elementId", "text"];
576
+ };
577
+ };
578
+ readonly 'mobile: pushFile': {
579
+ readonly command: "mobilePushFile";
580
+ readonly params: {
581
+ readonly required: readonly ["payload", "remotePath"];
582
+ };
583
+ };
584
+ readonly 'mobile: pullFile': {
585
+ readonly command: "mobilePullFile";
586
+ readonly params: {
587
+ readonly required: readonly ["remotePath"];
588
+ };
589
+ };
590
+ readonly 'mobile: pullFolder': {
591
+ readonly command: "mobilePullFolder";
592
+ readonly params: {
593
+ readonly required: readonly ["remotePath"];
594
+ };
595
+ };
596
+ readonly 'mobile: deleteFile': {
597
+ readonly command: "mobileDeleteFile";
598
+ readonly params: {
599
+ readonly required: readonly ["remotePath"];
600
+ };
601
+ };
602
+ readonly 'mobile: isAppInstalled': {
603
+ readonly command: "mobileIsAppInstalled";
604
+ readonly params: {
605
+ readonly required: readonly ["appId"];
606
+ };
607
+ };
608
+ readonly 'mobile: queryAppState': {
609
+ readonly command: "mobileQueryAppState";
610
+ readonly params: {
611
+ readonly required: readonly ["appId"];
612
+ };
613
+ };
614
+ readonly 'mobile: activateApp': {
615
+ readonly command: "mobileActivateApp";
616
+ readonly params: {
617
+ readonly required: readonly ["appId"];
618
+ };
619
+ };
620
+ readonly 'mobile: removeApp': {
621
+ readonly command: "mobileRemoveApp";
622
+ readonly params: {
623
+ readonly required: readonly ["appId"];
624
+ readonly optional: readonly ["timeout", "keepData"];
625
+ };
626
+ };
627
+ readonly 'mobile: terminateApp': {
628
+ readonly command: "mobileTerminateApp";
629
+ readonly params: {
630
+ readonly required: readonly ["appId"];
631
+ readonly optional: readonly ["timeout"];
632
+ };
633
+ };
634
+ readonly 'mobile: installApp': {
635
+ readonly command: "mobileInstallApp";
636
+ readonly params: {
637
+ readonly required: readonly ["appPath"];
638
+ readonly optional: readonly ["timeout", "keepData"];
639
+ };
640
+ };
641
+ readonly 'mobile: clearApp': {
642
+ readonly command: "mobileClearApp";
643
+ readonly params: {
644
+ readonly required: readonly ["appId"];
645
+ };
646
+ };
647
+ readonly 'mobile: backgroundApp': {
648
+ readonly command: "mobileBackgroundApp";
649
+ readonly params: {
650
+ readonly optional: readonly ["seconds"];
651
+ };
652
+ };
653
+ readonly 'mobile: getCurrentActivity': {
654
+ readonly command: "getCurrentActivity";
655
+ };
656
+ readonly 'mobile: getCurrentPackage': {
657
+ readonly command: "getCurrentPackage";
658
+ };
659
+ readonly 'mobile: startActivity': {
660
+ readonly command: "mobileStartActivity";
661
+ readonly params: {
662
+ readonly optional: readonly ["wait", "stop", "windowingMode", "activityType", "display"];
663
+ };
664
+ };
665
+ readonly 'mobile: startService': {
666
+ readonly command: "mobileStartService";
667
+ readonly params: {
668
+ readonly optional: readonly ["user", "intent", "action", "package", "uri", "mimeType", "identifier", "component", "categories", "extras", "flags", "wait", "stop", "windowingMode", "activityType", "display"];
669
+ };
670
+ };
671
+ readonly 'mobile: stopService': {
672
+ readonly command: "mobileStopService";
673
+ readonly params: {
674
+ readonly optional: readonly ["user", "intent", "action", "package", "uri", "mimeType", "identifier", "component", "categories", "extras", "flags"];
675
+ };
676
+ };
677
+ readonly 'mobile: broadcast': {
678
+ readonly command: "mobileBroadcast";
679
+ readonly params: {
680
+ readonly optional: readonly ["user", "intent", "action", "package", "uri", "mimeType", "identifier", "component", "categories", "extras", "flags", "receiverPermission", "allowBackgroundActivityStarts"];
681
+ };
682
+ };
683
+ readonly 'mobile: getContexts': {
684
+ readonly command: "mobileGetContexts";
685
+ };
686
+ readonly 'mobile: getAppStrings': {
687
+ readonly command: "mobileGetAppStrings";
688
+ readonly params: {
689
+ readonly optional: readonly ["language"];
690
+ };
691
+ };
692
+ readonly 'mobile: installMultipleApks': {
693
+ readonly command: "mobileInstallMultipleApks";
694
+ readonly params: {
695
+ readonly required: readonly ["apks"]; /**
696
+ * @privateRemarks moved from `this.opts`
697
+ */
698
+ readonly optional: readonly ["options"];
699
+ };
700
+ };
701
+ readonly 'mobile: lock': {
702
+ readonly command: "mobileLock";
703
+ readonly params: {
704
+ readonly optional: readonly ["seconds"];
705
+ };
706
+ };
707
+ readonly 'mobile: unlock': {
708
+ readonly command: "mobileUnlock";
709
+ readonly params: {
710
+ readonly optional: readonly ["key", "type", "strategy", "timeoutMs"];
711
+ };
712
+ };
713
+ readonly 'mobile: isLocked': {
714
+ readonly command: "isLocked";
715
+ };
716
+ readonly 'mobile: refreshGpsCache': {
717
+ readonly command: "mobileRefreshGpsCache";
718
+ readonly params: {
719
+ readonly optional: readonly ["timeoutMs"];
720
+ };
721
+ };
722
+ readonly 'mobile: startMediaProjectionRecording': {
723
+ readonly command: "mobileStartMediaProjectionRecording";
724
+ readonly params: {
725
+ readonly optional: readonly ["resolution", "maxDurationSec", "priority", "filename"];
726
+ };
727
+ };
728
+ readonly 'mobile: isMediaProjectionRecordingRunning': {
729
+ readonly command: "mobileIsMediaProjectionRecordingRunning";
730
+ };
731
+ readonly 'mobile: stopMediaProjectionRecording': {
732
+ readonly command: "mobileStopMediaProjectionRecording";
733
+ readonly params: {
734
+ readonly optional: readonly ["remotePath", "user", "pass", "method", "headers", "fileFieldName", "formFields", "uploadTimeout"];
735
+ };
736
+ };
737
+ readonly 'mobile: getConnectivity': {
738
+ readonly command: "mobileGetConnectivity";
739
+ readonly params: {
740
+ readonly optional: readonly ["services"];
741
+ };
742
+ };
743
+ readonly 'mobile: setConnectivity': {
744
+ readonly command: "mobileSetConnectivity";
745
+ readonly params: {
746
+ readonly optional: readonly ["wifi", "data", "airplaneMode"];
747
+ };
748
+ };
749
+ readonly 'mobile: toggleGps': {
750
+ readonly command: "toggleLocationServices";
751
+ };
752
+ readonly 'mobile: isGpsEnabled': {
753
+ readonly command: "isLocationServicesEnabled";
754
+ };
755
+ readonly 'mobile: hideKeyboard': {
756
+ readonly command: "hideKeyboard";
757
+ };
758
+ readonly 'mobile: isKeyboardShown': {
759
+ readonly command: "isKeyboardShown";
760
+ };
761
+ readonly 'mobile: pressKey': {
762
+ readonly command: "mobilePressKey";
763
+ readonly params: {
764
+ readonly required: readonly ["keycode"];
765
+ readonly optional: readonly ["metastate", "flags", "isLongPress"];
766
+ };
767
+ };
768
+ readonly 'mobile: getDisplayDensity': {
769
+ readonly command: "getDisplayDensity";
770
+ };
771
+ readonly 'mobile: getSystemBars': {
772
+ readonly command: "getSystemBars";
773
+ };
774
+ readonly 'mobile: fingerprint': {
775
+ readonly command: "mobileFingerprint";
776
+ readonly params: {
777
+ readonly required: readonly ["fingerprintId"];
778
+ };
779
+ };
780
+ readonly 'mobile: sendSms': {
781
+ readonly command: "mobileSendSms";
782
+ readonly params: {
783
+ readonly required: readonly ["phoneNumber", "message"];
784
+ };
785
+ };
786
+ readonly 'mobile: gsmCall': {
787
+ readonly command: "mobileGsmCall";
788
+ readonly params: {
789
+ readonly required: readonly ["phoneNumber", "action"];
790
+ };
791
+ };
792
+ readonly 'mobile: gsmSignal': {
793
+ readonly command: "mobileGsmSignal";
794
+ readonly params: {
795
+ readonly required: readonly ["strength"];
796
+ };
797
+ };
798
+ readonly 'mobile: gsmVoice': {
799
+ readonly command: "mobileGsmVoice";
800
+ readonly params: {
801
+ readonly required: readonly ["state"];
802
+ };
803
+ };
804
+ readonly 'mobile: powerAc': {
805
+ readonly command: "mobilePowerAc";
806
+ readonly params: {
807
+ readonly required: readonly ["state"];
808
+ };
809
+ };
810
+ readonly 'mobile: powerCapacity': {
811
+ readonly command: "mobilePowerCapacity";
812
+ readonly params: {
813
+ readonly required: readonly ["percent"];
814
+ };
815
+ };
816
+ readonly 'mobile: networkSpeed': {
817
+ readonly command: "mobileNetworkSpeed";
818
+ readonly params: {
819
+ readonly required: readonly ["speed"];
820
+ };
821
+ };
822
+ readonly 'mobile: sensorSet': {
823
+ readonly command: "sensorSet";
824
+ readonly params: {
825
+ readonly required: readonly ["sensorType", "value"];
826
+ };
827
+ };
828
+ readonly 'mobile: getPerformanceData': {
829
+ readonly command: "mobileGetPerformanceData";
830
+ readonly params: {
831
+ readonly required: readonly ["packageName", "dataType"];
832
+ };
833
+ };
834
+ readonly 'mobile: getPerformanceDataTypes': {
835
+ readonly command: "getPerformanceDataTypes";
836
+ };
837
+ readonly 'mobile: statusBar': {
838
+ readonly command: "mobilePerformStatusBarCommand";
839
+ readonly params: {
840
+ readonly required: readonly ["command"];
841
+ readonly optional: readonly ["component"];
842
+ };
843
+ };
844
+ readonly 'mobile: screenshots': {
845
+ readonly command: "mobileScreenshots";
846
+ readonly params: {
847
+ readonly optional: readonly ["displayId"];
848
+ };
849
+ };
850
+ readonly 'mobile: scheduleAction': {
851
+ readonly command: "mobileScheduleAction";
852
+ readonly params: {
853
+ readonly optional: readonly ["opts"];
854
+ };
855
+ };
856
+ readonly 'mobile: getActionHistory': {
857
+ readonly command: "mobileGetActionHistory";
858
+ readonly params: {
859
+ readonly optional: readonly ["opts"];
860
+ };
861
+ };
862
+ readonly 'mobile: unscheduleAction': {
863
+ readonly command: "mobileUnscheduleAction";
864
+ readonly params: {
865
+ readonly optional: readonly ["opts"];
866
+ };
867
+ };
868
+ };
869
+ uiautomator2?: UiAutomator2Server;
870
+ /**
871
+ * @privateRemarks moved from `this.opts`
872
+ */
873
+ systemPort: number | undefined;
874
+ _hasSystemPortInCaps: boolean | undefined;
875
+ mjpegStream?: mjpeg.MJpegStream;
876
+ caps: Uiautomator2DriverCaps;
877
+ opts: Uiautomator2DriverOpts;
878
+ desiredCapConstraints: Uiautomator2Constraints;
879
+ constructor(opts?: InitialOpts, shouldValidateCaps?: boolean);
880
+ validateDesiredCaps(caps: any): caps is Uiautomator2DriverCaps;
881
+ createSession(w3cCaps1: W3CUiautomator2DriverCaps, w3cCaps2?: W3CUiautomator2DriverCaps, w3cCaps3?: W3CUiautomator2DriverCaps, driverData?: DriverData[]): Promise<Uiautomator2CreateResult>;
882
+ getDeviceDetails(): Promise<Uiautomator2DeviceDetails>;
883
+ get driverData(): {};
884
+ getSession(): Promise<SingularSessionData<Uiautomator2Constraints>>;
885
+ isEmulator(): boolean;
886
+ setAvdFromCapabilities(caps: Uiautomator2StartSessionOpts): void;
887
+ allocateSystemPort(): Promise<void>;
888
+ releaseSystemPort(): Promise<void>;
889
+ allocateMjpegServerPort(): Promise<void>;
890
+ releaseMjpegServerPort(): Promise<void>;
891
+ startUiAutomator2Session(caps: Uiautomator2StartSessionOpts): Promise<Uiautomator2SessionCaps>;
892
+ getDeviceInfoFromUia2(): Promise<Uiautomator2DeviceInfo>;
893
+ initUiAutomator2Server(): Promise<UiAutomator2Server>;
894
+ initAUT(): Promise<void>;
895
+ ensureAppStarts(): Promise<void>;
896
+ deleteSession(): Promise<void>;
897
+ checkAppPresent(): Promise<void>;
898
+ onSettingsUpdate(): Promise<void>;
899
+ wrapBootstrapDisconnect(wrapped: () => Promise<void>): Promise<void>;
900
+ proxyActive(sessionId: string): boolean;
901
+ canProxy(sessionId: string): boolean;
902
+ getProxyAvoidList(): RouteMatcher[];
903
+ get isChromeSession(): boolean;
904
+ updateSettings(settings: Uiautomator2Settings): Promise<void>;
905
+ getSettings(): Promise<{
906
+ allowInvisibleElements: boolean;
907
+ ignoreUnimportantViews: boolean;
908
+ }>;
909
+ }
910
+ import './commands';
911
+ export { AndroidUiautomator2Driver };
912
+ //# sourceMappingURL=driver.d.ts.map