@wdio/protocols 8.0.15 → 8.2.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 (60) hide show
  1. package/build/commands/appium.d.ts +62 -62
  2. package/build/commands/appium.d.ts.map +1 -1
  3. package/build/commands/chromium.d.ts +28 -28
  4. package/build/commands/chromium.d.ts.map +1 -1
  5. package/build/commands/gecko.d.ts +5 -5
  6. package/build/commands/gecko.d.ts.map +1 -1
  7. package/build/commands/jsonwp.d.ts +95 -95
  8. package/build/commands/jsonwp.d.ts.map +1 -1
  9. package/build/commands/mjsonwp.d.ts +9 -9
  10. package/build/commands/mjsonwp.d.ts.map +1 -1
  11. package/build/commands/saucelabs.d.ts +10 -10
  12. package/build/commands/saucelabs.d.ts.map +1 -1
  13. package/build/commands/selenium.d.ts +6 -6
  14. package/build/commands/selenium.d.ts.map +1 -1
  15. package/build/commands/webdriver.d.ts +76 -76
  16. package/build/commands/webdriver.d.ts.map +1 -1
  17. package/build/commands/webdriverBidi.d.ts +2 -2
  18. package/build/commands/webdriverBidi.d.ts.map +1 -1
  19. package/build/index.d.ts +10 -40
  20. package/build/index.d.ts.map +1 -1
  21. package/build/index.js +9 -11
  22. package/build/protocols/appium.d.ts +1244 -0
  23. package/build/protocols/appium.d.ts.map +1 -0
  24. package/build/protocols/appium.js +1602 -0
  25. package/build/protocols/chromium.d.ts +384 -0
  26. package/build/protocols/chromium.d.ts.map +1 -0
  27. package/build/protocols/chromium.js +530 -0
  28. package/build/protocols/gecko.d.ts +76 -0
  29. package/build/protocols/gecko.d.ts.map +1 -0
  30. package/build/protocols/gecko.js +112 -0
  31. package/build/protocols/jsonwp.d.ts +1245 -0
  32. package/build/protocols/jsonwp.d.ts.map +1 -0
  33. package/build/protocols/jsonwp.js +1511 -0
  34. package/build/protocols/mjsonwp.d.ts +112 -0
  35. package/build/protocols/mjsonwp.d.ts.map +1 -0
  36. package/build/protocols/mjsonwp.js +126 -0
  37. package/build/protocols/saucelabs.d.ts +162 -0
  38. package/build/protocols/saucelabs.d.ts.map +1 -0
  39. package/build/protocols/saucelabs.js +297 -0
  40. package/build/protocols/selenium.d.ts +106 -0
  41. package/build/protocols/selenium.d.ts.map +1 -0
  42. package/build/protocols/selenium.js +132 -0
  43. package/build/protocols/webdriver.d.ts +1080 -0
  44. package/build/protocols/webdriver.d.ts.map +1 -0
  45. package/build/protocols/webdriver.js +1495 -0
  46. package/build/protocols/webdriverBidi.d.ts +35 -0
  47. package/build/protocols/webdriverBidi.d.ts.map +1 -0
  48. package/build/protocols/webdriverBidi.js +37 -0
  49. package/build/types.d.ts +8 -7
  50. package/build/types.d.ts.map +1 -1
  51. package/package.json +2 -2
  52. package/protocols/appium.json +0 -1469
  53. package/protocols/chromium.json +0 -494
  54. package/protocols/gecko.json +0 -105
  55. package/protocols/jsonwp.json +0 -1366
  56. package/protocols/mjsonwp.json +0 -114
  57. package/protocols/saucelabs.json +0 -276
  58. package/protocols/selenium.json +0 -122
  59. package/protocols/webdriver.json +0 -1331
  60. package/protocols/webdriverBidi.json +0 -33
@@ -1,1469 +0,0 @@
1
- {
2
- "/session/:sessionId/appium/device/shake": {
3
- "POST": {
4
- "command": "shake",
5
- "description": "Perform a shake action on the device.",
6
- "ref": "http://appium.io/docs/en/commands/device/interactions/shake/",
7
- "parameters": [],
8
- "support": {
9
- "ios": {
10
- "XCUITest": "9.3+",
11
- "UIAutomation": "8.0 to 9.3"
12
- }
13
- }
14
- }
15
- },
16
- "/session/:sessionId/appium/device/lock": {
17
- "POST": {
18
- "command": "lock",
19
- "description": "Lock the device.",
20
- "ref": "http://appium.io/docs/en/commands/device/interactions/lock/",
21
- "parameters": [{
22
- "name": "seconds",
23
- "type": "number",
24
- "description": "how long to lock the screen (iOS only)",
25
- "required": false
26
- }],
27
- "support": {
28
- "ios": {
29
- "UIAutomation": "8.0 to 9.3"
30
- },
31
- "android": {
32
- "UiAutomator": "4.2+"
33
- },
34
- "windows": {
35
- "Windows": "10+"
36
- }
37
- }
38
- }
39
- },
40
- "/session/:sessionId/appium/device/unlock": {
41
- "POST": {
42
- "command": "unlock",
43
- "description": "Unlock the device.",
44
- "ref": "http://appium.io/docs/en/commands/device/interactions/unlock/",
45
- "parameters": [],
46
- "support": {
47
- "android": {
48
- "UiAutomator": "4.2+"
49
- },
50
- "windows": {
51
- "Windows": "10+"
52
- }
53
- }
54
- }
55
- },
56
- "/session/:sessionId/appium/device/is_locked": {
57
- "POST": {
58
- "command": "isLocked",
59
- "description": "Check whether the device is locked or not.",
60
- "ref": "http://appium.io/docs/en/commands/device/interactions/is-locked/",
61
- "parameters": [],
62
- "returns": {
63
- "type": "boolean",
64
- "name": "isLocked",
65
- "description": "True if the device is locked, false if not"
66
- },
67
- "support": {
68
- "android": {
69
- "UiAutomator": "4.2+"
70
- },
71
- "windows": {
72
- "Windows": "10+"
73
- }
74
- }
75
- }
76
- },
77
- "/session/:sessionId/appium/start_recording_screen": {
78
- "POST": {
79
- "command": "startRecordingScreen",
80
- "description": "Start recording the screen.",
81
- "ref": "http://appium.io/docs/en/commands/device/recording-screen/start-recording-screen/",
82
- "parameters": [{
83
- "name": "options",
84
- "type": "object",
85
- "description": "command parameters that can contain keys like: remotePath, username, password, method, forceRestart, timeLimit, videoType, videoQuality, videoFps, bitRate, videoSize, bugReport (see more description in Appium docs)",
86
- "required": false
87
- }],
88
- "support": {
89
- "ios": {
90
- "XCUITest": "9.3+"
91
- },
92
- "android": {
93
- "UiAutomator": "4.2+"
94
- }
95
- }
96
- }
97
- },
98
- "/session/:sessionId/appium/stop_recording_screen": {
99
- "POST": {
100
- "command": "stopRecordingScreen",
101
- "description": "Stop recording screen",
102
- "ref": "http://appium.io/docs/en/commands/device/recording-screen/stop-recording-screen/",
103
- "parameters": [{
104
- "name": "remotePath",
105
- "type": "string",
106
- "description": "The path to the remote location, where the resulting video should be uploaded. The following protocols are supported http/https, ftp. This option only has an effect if there is screen recording process in progreess and forceRestart parameter is not set to true. Null or empty string value (the default setting) means the content of resulting file should be encoded as Base64.",
107
- "required": false
108
- }, {
109
- "name": "username",
110
- "type": "string",
111
- "description": "The name of the user for the remote authentication.",
112
- "required": false
113
- }, {
114
- "name": "password",
115
- "type": "string",
116
- "description": "The password for the remote authentication.",
117
- "required": false
118
- }, {
119
- "name": "method",
120
- "type": "string",
121
- "description": "The http multipart upload method name. The 'PUT' one is used by default.",
122
- "required": false
123
- }],
124
- "returns": {
125
- "type": "string",
126
- "name": "response",
127
- "description": "Base64 encoded string. If remote_path is set, the response is empty string"
128
- },
129
- "support": {
130
- "ios": {
131
- "XCUITest": "9.3+"
132
- },
133
- "android": {
134
- "UiAutomator": "4.2+"
135
- }
136
- }
137
- }
138
- },
139
- "/session/:sessionId/appium/performanceData/types": {
140
- "POST": {
141
- "command": "getPerformanceDataTypes",
142
- "description": "Returns the information types of the system state which is supported to read as like cpu, memory, network traffic, and battery.",
143
- "ref": "http://appium.io/docs/en/commands/device/performance-data/performance-data-types/",
144
- "parameters": [],
145
- "returns": {
146
- "type": "string[]",
147
- "name": "performanceTypes",
148
- "description": "The available performance data types (cpuinfo|batteryinfo|networkinfo|memoryinfo)"
149
- },
150
- "support": {
151
- "android": {
152
- "UiAutomator": "4.2+"
153
- }
154
- }
155
- }
156
- },
157
- "/session/:sessionId/appium/getPerformanceData": {
158
- "POST": {
159
- "command": "getPerformanceData",
160
- "description": "Returns the information of the system state which is supported to read as like cpu, memory, network traffic, and battery.",
161
- "ref": "http://appium.io/docs/en/commands/device/performance-data/get-performance-data/",
162
- "parameters": [{
163
- "name": "packageName",
164
- "type": "string",
165
- "description": "the package name of the application",
166
- "required": true
167
- }, {
168
- "name": "dataType",
169
- "type": "string",
170
- "description": "the type of system state which wants to read. It should be one of the supported performance data types",
171
- "required": true
172
- }, {
173
- "name": "dataReadTimeout",
174
- "type": "number",
175
- "description": "the number of attempts to read",
176
- "required": false
177
- }],
178
- "returns": {
179
- "type": "string[]",
180
- "name": "performanceData",
181
- "description": "The information type of the system state which is supported to read as like cpu, memory, network traffic, and battery"
182
- },
183
- "support": {
184
- "android": {
185
- "UiAutomator": "4.2+"
186
- }
187
- }
188
- }
189
- },
190
- "/session/:sessionId/appium/device/press_keycode": {
191
- "POST": {
192
- "command": "pressKeyCode",
193
- "description": "Press a particular key on the device.",
194
- "ref": "http://appium.io/docs/en/commands/device/keys/press-keycode/",
195
- "parameters": [{
196
- "name": "keycode",
197
- "type": "number",
198
- "description": "keycode to press",
199
- "required": true
200
- }, {
201
- "name": "metastate",
202
- "type": "number",
203
- "description": "meta state to press the keycode with",
204
- "required": false
205
- }, {
206
- "name": "flags",
207
- "type": "number",
208
- "description": "flags for the keypress",
209
- "required": false
210
- }],
211
- "support": {
212
- "android": {
213
- "UiAutomator": "4.2+"
214
- }
215
- }
216
- }
217
- },
218
- "/session/:sessionId/appium/device/long_press_keycode": {
219
- "POST": {
220
- "command": "longPressKeyCode",
221
- "description": "Press and hold a particular key code on the device.",
222
- "ref": "http://appium.io/docs/en/commands/device/keys/long-press-keycode/",
223
- "parameters": [{
224
- "name": "keycode",
225
- "type": "number",
226
- "description": "keycode to press on the device",
227
- "required": true
228
- }, {
229
- "name": "metastate",
230
- "type": "number",
231
- "description": "metastate for the keypress",
232
- "required": false
233
- }, {
234
- "name": "flags",
235
- "type": "number",
236
- "description": "flags for the keypress",
237
- "required": false
238
- }],
239
- "support": {
240
- "android": {
241
- "UiAutomator": "4.2+"
242
- }
243
- }
244
- }
245
- },
246
- "/session/:sessionId/appium/device/keyevent": {
247
- "POST": {
248
- "command": "sendKeyEvent",
249
- "description": "Send a key code to the device.",
250
- "ref": "https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints",
251
- "parameters": [{
252
- "name": "keycode",
253
- "type": "string",
254
- "description": "keycode to press",
255
- "required": true
256
- }, {
257
- "name": "metastate",
258
- "type": "string",
259
- "description": "meta state to press the keycode with",
260
- "required": false
261
- }],
262
- "support": {}
263
- }
264
- },
265
- "/session/:sessionId/appium/device/rotate": {
266
- "POST": {
267
- "command": "rotateDevice",
268
- "description": "Rotate the device in three dimensions.",
269
- "ref": "http://appium.io/docs/en/commands/device/interactions/rotate/",
270
- "parameters": [{
271
- "name": "x",
272
- "type": "number",
273
- "description": "x offset to use for the center of the rotate gesture",
274
- "required": true,
275
- "default": 0
276
- }, {
277
- "name": "y",
278
- "type": "number",
279
- "description": "y offset to use for the center of the rotate gesture",
280
- "required": true,
281
- "default": 0
282
- }, {
283
- "name": "radius",
284
- "type": "number",
285
- "description": "the distance in points from the center to the edge of the circular path",
286
- "required": true,
287
- "default": 0
288
- }, {
289
- "name": "rotation",
290
- "type": "number",
291
- "description": "the length of rotation in radians",
292
- "required": true,
293
- "default": 3.14159265359
294
- }, {
295
- "name": "touchCount",
296
- "type": "number",
297
- "description": "the number of touches to use in the specified gesture",
298
- "required": true,
299
- "default": 2
300
- }, {
301
- "name": "duration",
302
- "type": "number",
303
- "description": "the length of hold time for the specified gesture, in seconds",
304
- "required": true,
305
- "default": 1
306
- }, {
307
- "name": "element",
308
- "type": "string",
309
- "description": "the id of an element returned in a previous call to execute the rotation on",
310
- "required": false
311
- }],
312
- "support": {
313
- "ios": {
314
- "UIAutomation": "8.0 to 9.3"
315
- }
316
- }
317
- }
318
- },
319
- "/session/:sessionId/appium/device/current_activity": {
320
- "GET": {
321
- "command": "getCurrentActivity",
322
- "description": "Get the name of the current Android activity.",
323
- "ref": "http://appium.io/docs/en/commands/device/activity/current-activity/",
324
- "parameters": [],
325
- "returns": {
326
- "type": "string",
327
- "name": "activity",
328
- "description": "Name of the current activity"
329
- },
330
- "support": {
331
- "android": {
332
- "UiAutomator": "4.2+"
333
- }
334
- }
335
- }
336
- },
337
- "/session/:sessionId/appium/device/current_package": {
338
- "GET": {
339
- "command": "getCurrentPackage",
340
- "description": "Get the name of the current Android package.",
341
- "ref": "http://appium.io/docs/en/commands/device/activity/current-package/",
342
- "parameters": [],
343
- "returns": {
344
- "type": "string",
345
- "name": "package",
346
- "description": "Name of the current package"
347
- },
348
- "support": {
349
- "android": {
350
- "UiAutomator": "4.2+"
351
- }
352
- }
353
- }
354
- },
355
- "/session/:sessionId/appium/device/install_app": {
356
- "POST": {
357
- "command": "installApp",
358
- "description": "Install the given app onto the device.",
359
- "ref": "http://appium.io/docs/en/commands/device/app/install-app/",
360
- "parameters": [{
361
- "name": "appPath",
362
- "type": "string",
363
- "description": "path to application .apk file",
364
- "required": true
365
- }],
366
- "support": {
367
- "ios": {
368
- "XCUITest": "9.3+",
369
- "UIAutomation": "8.0 to 9.3"
370
- },
371
- "android": {
372
- "UiAutomator": "4.2+"
373
- }
374
- }
375
- }
376
- },
377
- "/session/:sessionId/appium/device/activate_app": {
378
- "POST": {
379
- "command": "activateApp",
380
- "description": "Activate the given app onto the device",
381
- "ref": "http://appium.io/docs/en/commands/device/app/activate-app/",
382
- "parameters": [{
383
- "name": "appId",
384
- "type": "string",
385
- "description": "App ID (package ID for Android, bundle ID for iOS)",
386
- "required": true
387
- }],
388
- "support": {
389
- "ios": {
390
- "XCUITest": "9.3+"
391
- },
392
- "android": {
393
- "UiAutomator": "4.2+"
394
- }
395
- }
396
- }
397
- },
398
- "/session/:sessionId/appium/device/remove_app": {
399
- "POST": {
400
- "command": "removeApp",
401
- "description": "Remove an app from the device.",
402
- "ref": "http://appium.io/docs/en/commands/device/app/remove-app/",
403
- "parameters": [{
404
- "name": "appId",
405
- "type": "string",
406
- "description": "App ID (package ID for Android, bundle ID for iOS)",
407
- "required": true
408
- }],
409
- "support": {
410
- "ios": {
411
- "XCUITest": "9.3+",
412
- "UIAutomation": "8.0 to 9.3"
413
- },
414
- "android": {
415
- "UiAutomator": "4.2+"
416
- }
417
- }
418
- }
419
- },
420
- "/session/:sessionId/appium/device/terminate_app": {
421
- "POST": {
422
- "command": "terminateApp",
423
- "description": "Terminate the given app on the device",
424
- "ref": "http://appium.io/docs/en/commands/device/app/terminate-app/",
425
- "parameters": [{
426
- "name": "appId",
427
- "type": "string",
428
- "description": "App ID (package ID for Android, bundle ID for iOS)",
429
- "required": true
430
- }],
431
- "support": {
432
- "ios": {
433
- "XCUITest": "9.3+"
434
- },
435
- "android": {
436
- "UiAutomator": "4.2+"
437
- }
438
- }
439
- }
440
- },
441
- "/session/:sessionId/appium/device/app_installed": {
442
- "POST": {
443
- "command": "isAppInstalled",
444
- "description": "Check whether the specified app is installed on the device.",
445
- "ref": "http://appium.io/docs/en/commands/device/app/is-app-installed/",
446
- "parameters": [{
447
- "name": "appId",
448
- "type": "string",
449
- "description": "App ID (package ID for Android, bundle ID for iOS)",
450
- "required": true
451
- }],
452
- "returns": {
453
- "type": "boolean",
454
- "name": "isAppInstalled",
455
- "description": "Return true if installed, false if not"
456
- },
457
- "support": {
458
- "ios": {
459
- "XCUITest": "9.3+",
460
- "UIAutomation": "8.0 to 9.3"
461
- },
462
- "android": {
463
- "UiAutomator": "4.2+"
464
- }
465
- }
466
- }
467
- },
468
- "/session/:sessionId/appium/device/app_state": {
469
- "POST": {
470
- "command": "queryAppState",
471
- "description": "Get the given app status on the device",
472
- "ref": "http://appium.io/docs/en/commands/device/app/app-state/",
473
- "parameters": [{
474
- "name": "appId",
475
- "type": "string",
476
- "description": "App ID (package ID for Android, bundle ID for iOS)",
477
- "required": true
478
- }],
479
- "returns": {
480
- "type": "number",
481
- "name": "appStatus",
482
- "description": "0 is not installed. 1 is not running. 2 is running in background or suspended. 3 is running in background. 4 is running in foreground"
483
- },
484
- "support": {
485
- "ios": {
486
- "XCUITest": "9.3+"
487
- },
488
- "android": {
489
- "UiAutomator": "4.2+"
490
- }
491
- }
492
- }
493
- },
494
- "/session/:sessionId/appium/device/hide_keyboard": {
495
- "POST": {
496
- "command": "hideKeyboard",
497
- "description": "Hide soft keyboard.",
498
- "ref": "http://appium.io/docs/en/commands/device/keys/hide-keyboard/",
499
- "parameters": [{
500
- "name": "strategy",
501
- "type": "string",
502
- "description": "hide keyboard strategy (UIAutomation only), available strategies - 'press', 'pressKey', 'swipeDown', 'tapOut', 'tapOutside', 'default'",
503
- "required": false
504
- }, {
505
- "name": "key",
506
- "type": "string",
507
- "description": "key value if strategy is 'pressKey'",
508
- "required": false
509
- }, {
510
- "name": "keyCode",
511
- "type": "string",
512
- "description": "key code if strategy is 'pressKey'",
513
- "required": false
514
- }, {
515
- "name": "keyName",
516
- "type": "string",
517
- "description": "key name if strategy is 'pressKey'",
518
- "required": false
519
- }],
520
- "support": {
521
- "ios": {
522
- "XCUITest": "9.3+",
523
- "UIAutomation": "8.0 to 9.3"
524
- },
525
- "android": {
526
- "UiAutomator": "4.2+"
527
- },
528
- "windows": {
529
- "Windows": "10+"
530
- }
531
- }
532
- }
533
- },
534
- "/session/:sessionId/appium/device/is_keyboard_shown": {
535
- "GET": {
536
- "command": "isKeyboardShown",
537
- "description": "Whether or not the soft keyboard is shown.",
538
- "ref": "http://appium.io/docs/en/commands/device/keys/is-keyboard-shown/",
539
- "parameters": [],
540
- "returns": {
541
- "type": "boolean",
542
- "name": "isKeyboardShown",
543
- "description": "True if the keyboard is shown"
544
- },
545
- "support": {
546
- "ios": {
547
- "XCUITest": "9.3+",
548
- "UIAutomation": "8.0 to 9.3"
549
- },
550
- "android": {
551
- "UiAutomator": "4.2+"
552
- },
553
- "windows": {
554
- "Windows": "10+"
555
- }
556
- }
557
- }
558
- },
559
- "/session/:sessionId/appium/device/push_file": {
560
- "POST": {
561
- "command": "pushFile",
562
- "description": "Place a file onto the device in a particular place.",
563
- "ref": "http://appium.io/docs/en/commands/device/files/push-file/",
564
- "parameters": [{
565
- "name": "path",
566
- "type": "string",
567
- "description": "path to install the data to",
568
- "required": true
569
- }, {
570
- "name": "data",
571
- "type": "string",
572
- "description": "contents of file in base64",
573
- "required": true
574
- }],
575
- "support": {
576
- "ios": {
577
- "XCUITest": "9.3+",
578
- "UIAutomation": "8.0 to 9.3"
579
- },
580
- "android": {
581
- "UiAutomator": "4.2+"
582
- }
583
- }
584
- }
585
- },
586
- "/session/:sessionId/appium/device/pull_file": {
587
- "POST": {
588
- "command": "pullFile",
589
- "description": "Retrieve a file from the device's file system.",
590
- "ref": "http://appium.io/docs/en/commands/device/files/pull-file/",
591
- "parameters": [{
592
- "name": "path",
593
- "type": "string",
594
- "description": "path on the device to pull file from",
595
- "required": true
596
- }],
597
- "support": {
598
- "ios": {
599
- "XCUITest": "9.3+",
600
- "UIAutomation": "8.0 to 9.3"
601
- },
602
- "android": {
603
- "UiAutomator": "4.2+"
604
- }
605
- },
606
- "returns": {
607
- "type": "string",
608
- "name": "response",
609
- "description": "Contents of file in base64"
610
- }
611
- }
612
- },
613
- "/session/:sessionId/appium/device/pull_folder": {
614
- "POST": {
615
- "command": "pullFolder",
616
- "description": "Retrieve a folder from the device's file system.",
617
- "ref": "http://appium.io/docs/en/commands/device/files/pull-folder/",
618
- "parameters": [{
619
- "name": "path",
620
- "type": "string",
621
- "description": "path to an entire folder on the device",
622
- "required": true
623
- }],
624
- "support": {
625
- "ios": {
626
- "XCUITest": "9.3+",
627
- "UIAutomation": "8.0 to 9.3"
628
- },
629
- "android": {
630
- "UiAutomator": "4.2+"
631
- }
632
- }
633
- }
634
- },
635
- "/session/:sessionId/appium/device/toggle_airplane_mode": {
636
- "POST": {
637
- "command": "toggleAirplaneMode",
638
- "description": "Toggle airplane mode on device.",
639
- "ref": "http://appium.io/docs/en/commands/device/network/toggle-airplane-mode/",
640
- "parameters": [],
641
- "support": {
642
- "android": {
643
- "UiAutomator": "4.2+"
644
- }
645
- }
646
- }
647
- },
648
- "/session/:sessionId/appium/device/toggle_data": {
649
- "POST": {
650
- "command": "toggleData",
651
- "description": "Switch the state of data service.",
652
- "ref": "http://appium.io/docs/en/commands/device/network/toggle-data/",
653
- "parameters": [],
654
- "support": {
655
- "android": {
656
- "UiAutomator": "4.2+"
657
- }
658
- }
659
- }
660
- },
661
- "/session/:sessionId/appium/device/toggle_wifi": {
662
- "POST": {
663
- "command": "toggleWiFi",
664
- "description": "Switch the state of the wifi service.",
665
- "ref": "http://appium.io/docs/en/commands/device/network/toggle-wifi/",
666
- "parameters": [],
667
- "support": {
668
- "android": {
669
- "UiAutomator": "4.2+"
670
- }
671
- }
672
- }
673
- },
674
- "/session/:sessionId/appium/device/toggle_location_services": {
675
- "POST": {
676
- "command": "toggleLocationServices",
677
- "description": "Switch the state of the location service.",
678
- "ref": "http://appium.io/docs/en/commands/device/network/toggle-location-services/",
679
- "parameters": [],
680
- "support": {
681
- "android": {
682
- "UiAutomator": "4.2+"
683
- }
684
- }
685
- }
686
- },
687
- "/session/:sessionId/appium/device/network_speed": {
688
- "POST": {
689
- "command": "toggleNetworkSpeed",
690
- "description": "Set network speed (Emulator only)",
691
- "ref": "http://appium.io/docs/en/commands/device/network/network-speed/",
692
- "parameters": [{
693
- "name": "netspeed",
694
- "type": "string",
695
- "description": "Network type - 'full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo'",
696
- "required": true
697
- }],
698
- "support": {
699
- "android": {
700
- "UiAutomator": "4.2+"
701
- }
702
- }
703
- }
704
- },
705
- "/session/:sessionId/appium/device/open_notifications": {
706
- "POST": {
707
- "command": "openNotifications",
708
- "description": "Open Android notifications (Emulator only).",
709
- "ref": "http://appium.io/docs/en/commands/device/system/open-notifications/",
710
- "parameters": [],
711
- "support": {
712
- "android": {
713
- "UiAutomator": "4.2+"
714
- }
715
- }
716
- }
717
- },
718
- "/session/:sessionId/appium/device/start_activity": {
719
- "POST": {
720
- "command": "startActivity",
721
- "description": "Start an Android activity by providing package name and activity name.",
722
- "ref": "http://appium.io/docs/en/commands/device/activity/start-activity/",
723
- "parameters": [{
724
- "name": "appPackage",
725
- "type": "string",
726
- "description": "name of app",
727
- "required": true
728
- }, {
729
- "name": "appActivity",
730
- "type": "string",
731
- "description": "name of activity",
732
- "required": true
733
- }, {
734
- "name": "appWaitPackage",
735
- "type": "string",
736
- "description": "name of app to wait for",
737
- "required": false
738
- }, {
739
- "name": "appWaitActivity",
740
- "type": "string",
741
- "description": "name of activity to wait for",
742
- "required": false
743
- }, {
744
- "name": "intentAction",
745
- "type": "string",
746
- "description": "intent action which will be used to start activity",
747
- "required": false,
748
- "default": "android.intent.action.MAIN"
749
- }, {
750
- "name": "intentCategory",
751
- "type": "string",
752
- "description": "intent category which will be used to start activity",
753
- "required": false,
754
- "default": "android.intent.category.LAUNCHER"
755
- }, {
756
- "name": "intentFlags",
757
- "type": "string",
758
- "description": "flags that will be used to start activity",
759
- "required": false,
760
- "default": "0x10200000"
761
- }, {
762
- "name": "optionalIntentArguments",
763
- "type": "string",
764
- "description": "additional intent arguments that will be used to start activity",
765
- "required": false
766
- }, {
767
- "name": "dontStopAppOnReset",
768
- "type": "string",
769
- "description": "doesn’t stop the process of the app under test, before starting the app using adb",
770
- "required": false
771
- }],
772
- "support": {
773
- "android": {
774
- "UiAutomator": "4.2+"
775
- }
776
- }
777
- }
778
- },
779
- "/session/:sessionId/appium/device/system_bars": {
780
- "GET": {
781
- "command": "getSystemBars",
782
- "description": "Retrieve visibility and bounds information of the status and navigation bars.",
783
- "ref": "http://appium.io/docs/en/commands/device/system/system-bars/",
784
- "parameters": [],
785
- "returns": {
786
- "type": "object[]",
787
- "name": "systemBars",
788
- "description": "Information about visibility and bounds of status and navigation bar"
789
- },
790
- "support": {
791
- "android": {
792
- "UiAutomator": "4.2+"
793
- }
794
- }
795
- }
796
- },
797
- "/session/:sessionId/appium/device/system_time": {
798
- "GET": {
799
- "command": "getDeviceTime",
800
- "description": "Get the time on the device.",
801
- "ref": "http://appium.io/docs/en/commands/device/system/system-time/",
802
- "parameters": [],
803
- "returns": {
804
- "type": "string",
805
- "name": "time",
806
- "description": "Time on the device"
807
- },
808
- "support": {
809
- "ios": {
810
- "XCUITest": "9.3+",
811
- "UIAutomation": "8.0 to 9.3"
812
- },
813
- "android": {
814
- "UiAutomator": "4.2+"
815
- }
816
- }
817
- }
818
- },
819
- "/session/:sessionId/appium/device/display_density": {
820
- "GET": {
821
- "command": "getDisplayDensity",
822
- "description": "Get display density from device.",
823
- "ref": "https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints",
824
- "parameters": [],
825
- "returns": {
826
- "type": "*",
827
- "name": "displayDensity"
828
- },
829
- "support": {
830
- "android": {
831
- "UiAutomator": "4.2+"
832
- }
833
- }
834
- }
835
- },
836
- "/session/:sessionId/appium/simulator/touch_id": {
837
- "POST": {
838
- "command": "touchId",
839
- "description": "Simulate a [touch id](https://support.apple.com/en-ca/ht201371) event (iOS Simulator only). To enable this feature, the `allowTouchIdEnroll` desired capability must be set to true and the Simulator must be [enrolled](https://support.apple.com/en-ca/ht201371). When you set allowTouchIdEnroll to true, it will set the Simulator to be enrolled by default. The enrollment state can be [toggled](http://appium.io/docs/en/commands/device/simulator/toggle-touch-id-enrollment/index.html). This call will only work if Appium process or its parent application (e.g. Terminal.app or Appium.app) has access to Mac OS accessibility in System Preferences > Security & Privacy > Privacy > Accessibility list.",
840
- "ref": "http://appium.io/docs/en/commands/device/simulator/touch-id/",
841
- "parameters": [{
842
- "name": "match",
843
- "type": "boolean",
844
- "description": "are we simulating a successful touch (true) or a failed touch (false)",
845
- "required": true
846
- }],
847
- "support": {
848
- "ios": {
849
- "XCUITest": "9.3+"
850
- }
851
- }
852
- }
853
- },
854
- "/session/:sessionId/appium/simulator/toggle_touch_id_enrollment": {
855
- "POST": {
856
- "command": "toggleEnrollTouchId",
857
- "description": "Toggle the simulator being [enrolled](https://support.apple.com/en-ca/ht201371) to accept touchId (iOS Simulator only). To enable this feature, the `allowTouchIdEnroll` desired capability must be set to true. When `allowTouchIdEnroll` is set to true the Simulator will be enrolled by default, and the 'Toggle Touch ID Enrollment' changes the enrollment state. This call will only work if the Appium process or its parent application (e.g., Terminal.app or Appium.app) has access to Mac OS accessibility in System Preferences > Security & Privacy > Privacy > Accessibility list.",
858
- "ref": "http://appium.io/docs/en/commands/device/simulator/toggle-touch-id-enrollment/",
859
- "parameters": [{
860
- "name": "enabled",
861
- "type": "boolean",
862
- "description": "equals to true if TouchID enrollment should be enabled",
863
- "required": false,
864
- "default": true
865
- }],
866
- "support": {
867
- "ios": {
868
- "XCUITest": "9.3+"
869
- }
870
- }
871
- }
872
- },
873
- "/session/:sessionId/appium/app/launch": {
874
- "POST": {
875
- "command": "launchApp",
876
- "description": "Launch an app on device. iOS tests with XCUITest can also use the `mobile: launchApp` method. See detailed [documentation](http://appium.io/docs/en/writing-running-appium/ios/ios-xctest-mobile-apps-management/index.html#mobile-launchapp).",
877
- "ref": "http://appium.io/docs/en/commands/device/app/launch-app/",
878
- "parameters": [],
879
- "support": {
880
- "ios": {
881
- "XCUITest": "9.3+",
882
- "UIAutomation": "8.0 to 9.3"
883
- },
884
- "android": {
885
- "UiAutomator": "4.2+"
886
- }
887
- }
888
- }
889
- },
890
- "/session/:sessionId/appium/app/close": {
891
- "POST": {
892
- "command": "closeApp",
893
- "description": "Close an app on device.",
894
- "ref": "http://appium.io/docs/en/commands/device/app/close-app/",
895
- "parameters": [],
896
- "support": {
897
- "ios": {
898
- "XCUITest": "9.3+",
899
- "UIAutomation": "8.0 to 9.3"
900
- },
901
- "android": {
902
- "UiAutomator": "4.2+"
903
- }
904
- }
905
- }
906
- },
907
- "/session/:sessionId/appium/app/background": {
908
- "POST": {
909
- "command": "background",
910
- "description": "Send the currently running app for this session to the background. iOS tests with XCUITest can also use the `mobile: terminateApp` method to terminate the current app (see detailed [documentation](http://appium.io/docs/en/writing-running-appium/ios/ios-xctest-mobile-apps-management/index.html#mobile-terminateapp)), and the `mobile: activateApp` to activate an existing application on the device under test and moves it to the foreground (see detailed [documentation](http://appium.io/docs/en/writing-running-appium/ios/ios-xctest-mobile-apps-management/index.html#mobile-activateapp)).",
911
- "ref": "http://appium.io/docs/en/commands/device/app/background-app/",
912
- "parameters": [{
913
- "name": "seconds",
914
- "type": "(number|null)",
915
- "description": "timeout to restore app, if 'null' app won't be restored",
916
- "required": true,
917
- "default": "null"
918
- }],
919
- "support": {
920
- "ios": {
921
- "XCUITest": "9.3+",
922
- "UIAutomation": "8.0 to 9.3"
923
- },
924
- "android": {
925
- "UiAutomator": "4.2+"
926
- }
927
- }
928
- }
929
- },
930
- "/session/:sessionId/appium/app/end_test_coverage": {
931
- "POST": {
932
- "command": "endCoverage",
933
- "description": "Get test coverage data.",
934
- "ref": "http://appium.io/docs/en/commands/device/app/end-test-coverage/",
935
- "parameters": [{
936
- "name": "intent",
937
- "type": "string",
938
- "description": "intent to broadcast",
939
- "required": true
940
- }, {
941
- "name": "path",
942
- "type": "string",
943
- "description": "path to .ec file",
944
- "required": true
945
- }],
946
- "support": {
947
- "android": {
948
- "UiAutomator": "4.2+"
949
- }
950
- }
951
- }
952
- },
953
- "/session/:sessionId/appium/app/strings": {
954
- "POST": {
955
- "command": "getStrings",
956
- "description": "Get app strings.",
957
- "ref": "http://appium.io/docs/en/commands/device/app/get-app-strings/",
958
- "parameters": [{
959
- "name": "language",
960
- "type": "string",
961
- "description": "language code",
962
- "required": false
963
- }, {
964
- "name": "stringFile",
965
- "type": "string",
966
- "description": "path to the string file",
967
- "required": false
968
- }],
969
- "returns": {
970
- "type": "object",
971
- "name": "appStrings",
972
- "description": "all defined Strings from an app for the specified language and strings filename"
973
- },
974
- "support": {
975
- "ios": {
976
- "XCUITest": "9.3+",
977
- "UIAutomation": "8.0 to 9.3"
978
- },
979
- "android": {
980
- "UiAutomator": "4.2+"
981
- }
982
- }
983
- }
984
- },
985
- "/session/:sessionId/appium/element/:elementId/value": {
986
- "POST": {
987
- "command": "setValueImmediate",
988
- "ref": "https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints",
989
- "variables": [{
990
- "name": "elementId",
991
- "description": "the id of an element returned in a previous call to Find Element(s)"
992
- }],
993
- "parameters": [{
994
- "name": "value",
995
- "type": "string",
996
- "description": "value to set on element",
997
- "required": true
998
- }],
999
- "support": {
1000
- "ios": {
1001
- "XCUITest": "9.3+"
1002
- }
1003
- }
1004
- }
1005
- },
1006
- "/session/:sessionId/appium/element/:elementId/replace_value": {
1007
- "POST": {
1008
- "command": "replaceValue",
1009
- "description": "Replace the value to element directly.",
1010
- "ref": "https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints",
1011
- "variables": [{
1012
- "name": "elementId",
1013
- "description": "the id of an element returned in a previous call to Find Element(s)"
1014
- }],
1015
- "parameters": [{
1016
- "name": "value",
1017
- "type": "string",
1018
- "description": "value to replace on element",
1019
- "required": true
1020
- }],
1021
- "support": {
1022
- "ios": {
1023
- "XCUITest": "9.3+",
1024
- "UIAutomation": "8.0 to 9.3"
1025
- },
1026
- "android": {
1027
- "UiAutomator": "4.2+"
1028
- }
1029
- }
1030
- }
1031
- },
1032
- "/session/:sessionId/appium/settings": {
1033
- "GET": {
1034
- "command": "getSettings",
1035
- "description": "Retrieve the current settings on the device.",
1036
- "ref": "http://appium.io/docs/en/commands/session/settings/get-settings/",
1037
- "parameters": [],
1038
- "returns": {
1039
- "type": "object",
1040
- "name": "settings",
1041
- "description": "JSON hash of all the currently specified settings, see Settings API"
1042
- },
1043
- "support": {
1044
- "ios": {
1045
- "XCUITest": "9.3+",
1046
- "UIAutomation": "8.0 to 9.3"
1047
- },
1048
- "android": {
1049
- "UiAutomator": "4.2+"
1050
- },
1051
- "windows": {
1052
- "Windows": "10+"
1053
- }
1054
- }
1055
- },
1056
- "POST": {
1057
- "command": "updateSettings",
1058
- "description": "Update the current setting on the device.",
1059
- "ref": "http://appium.io/docs/en/commands/session/settings/update-settings/",
1060
- "parameters": [{
1061
- "name": "settings",
1062
- "type": "object",
1063
- "description": "key/value object with settings to update",
1064
- "required": true
1065
- }],
1066
- "support": {
1067
- "ios": {
1068
- "XCUITest": "9.3+",
1069
- "UIAutomation": "8.0 to 9.3"
1070
- },
1071
- "android": {
1072
- "UiAutomator": "4.2+"
1073
- },
1074
- "windows": {
1075
- "Windows": "10+"
1076
- }
1077
- }
1078
- }
1079
- },
1080
- "/session/:sessionId/appium/receive_async_response": {
1081
- "POST": {
1082
- "command": "receiveAsyncResponse",
1083
- "description": "Callback url for asynchronous execution of JavaScript.",
1084
- "ref": "https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints",
1085
- "parameters": [{
1086
- "name": "response",
1087
- "type": "object",
1088
- "description": "response to receive on device",
1089
- "required": true
1090
- }],
1091
- "support": {}
1092
- }
1093
- },
1094
- "/session/:sessionId/appium/device/gsm_call": {
1095
- "POST": {
1096
- "command": "gsmCall",
1097
- "description": "Make GSM call (Emulator only).",
1098
- "ref": "http://appium.io/docs/en/commands/device/network/gsm-call/",
1099
- "parameters": [{
1100
- "name": "phoneNumber",
1101
- "type": "string",
1102
- "description": "the phone number to call to",
1103
- "required": true
1104
- }, {
1105
- "name": "action",
1106
- "type": "string",
1107
- "description": "The action - 'call', 'accept', 'cancel', 'hold'",
1108
- "required": true
1109
- }],
1110
- "support": {
1111
- "android": {
1112
- "UiAutomator": "4.2+"
1113
- }
1114
- }
1115
- }
1116
- },
1117
- "/session/:sessionId/appium/device/gsm_signal": {
1118
- "POST": {
1119
- "command": "gsmSignal",
1120
- "description": "Set GSM signal strength (Emulator only).",
1121
- "ref": "http://appium.io/docs/en/commands/device/network/gsm-signal/",
1122
- "parameters": [{
1123
- "name": "signalStrength",
1124
- "type": "string",
1125
- "description": "signal strength in the range [0, 4]",
1126
- "required": true
1127
- }, {
1128
- "name": "signalStrengh",
1129
- "type": "string",
1130
- "description": "signal strength in the range [0, 4]. Please also set this parameter with the same value if you use Appium v1.11.0 or lower (see https://github.com/appium/appium/issues/12234).",
1131
- "required": false
1132
- }],
1133
- "support": {
1134
- "android": {
1135
- "UiAutomator": "4.2+"
1136
- }
1137
- }
1138
- }
1139
- },
1140
- "/session/:sessionId/appium/device/power_capacity": {
1141
- "POST": {
1142
- "command": "powerCapacity",
1143
- "description": "Set the battery percentage (Emulator only).",
1144
- "ref": "http://appium.io/docs/en/commands/device/emulator/power_capacity/",
1145
- "parameters": [{
1146
- "name": "percent",
1147
- "type": "number",
1148
- "description": "percentage value in range [0, 100]",
1149
- "required": true
1150
- }],
1151
- "support": {
1152
- "android": {
1153
- "UiAutomator": "4.2+"
1154
- }
1155
- }
1156
- }
1157
- },
1158
- "/session/:sessionId/appium/device/power_ac": {
1159
- "POST": {
1160
- "command": "powerAC",
1161
- "description": "Set the state of the battery charger to connected or not (Emulator only).",
1162
- "ref": "http://appium.io/docs/en/commands/device/emulator/power_ac/",
1163
- "parameters": [{
1164
- "name": "state",
1165
- "type": "string",
1166
- "description": "set the state. on or off",
1167
- "required": true
1168
- }],
1169
- "support": {
1170
- "android": {
1171
- "UiAutomator": "4.2+"
1172
- }
1173
- }
1174
- }
1175
- },
1176
- "/session/:sessionId/appium/device/gsm_voice": {
1177
- "POST": {
1178
- "command": "gsmVoice",
1179
- "description": "Set GSM voice state (Emulator only).",
1180
- "ref": "http://appium.io/docs/en/commands/device/network/gsm-voice/",
1181
- "parameters": [{
1182
- "name": "state",
1183
- "type": "string",
1184
- "description": "state of GSM voice - 'unregistered', 'home', 'roaming', 'searching', 'denied', 'off', 'on'",
1185
- "required": true
1186
- }],
1187
- "support": {
1188
- "android": {
1189
- "UiAutomator": "4.2+"
1190
- }
1191
- }
1192
- }
1193
- },
1194
- "/session/:sessionId/appium/device/send_sms": {
1195
- "POST": {
1196
- "command": "sendSms",
1197
- "description": "Simulate an SMS message (Emulator only).",
1198
- "ref": "http://appium.io/docs/en/commands/device/network/send-sms/",
1199
- "parameters": [{
1200
- "name": "phoneNumber",
1201
- "type": "string",
1202
- "description": "the phone number to send the SMS too",
1203
- "required": true
1204
- }, {
1205
- "name": "message",
1206
- "type": "string",
1207
- "description": "the SMS message",
1208
- "required": true
1209
- }],
1210
- "support": {
1211
- "android": {
1212
- "UiAutomator": "4.2+"
1213
- }
1214
- }
1215
- }
1216
- },
1217
- "/session/:sessionId/appium/device/finger_print": {
1218
- "POST": {
1219
- "command": "fingerPrint",
1220
- "description": "Authenticate users by using their finger print scans on supported emulators.",
1221
- "ref": "http://appium.io/docs/en/commands/device/authentication/finger-print/",
1222
- "parameters": [{
1223
- "name": "fingerprintId",
1224
- "type": "number",
1225
- "description": "finger prints stored in Android Keystore system (from 1 to 10)",
1226
- "required": true
1227
- }],
1228
- "support": {
1229
- "android": {
1230
- "UiAutomator": "4.2+"
1231
- }
1232
- }
1233
- }
1234
- },
1235
- "/session/:sessionId/appium/device/set_clipboard": {
1236
- "POST": {
1237
- "command": "setClipboard",
1238
- "description": "Set the content of the system clipboard",
1239
- "ref": "http://appium.io/docs/en/commands/device/clipboard/set-clipboard/",
1240
- "parameters": [{
1241
- "name": "content",
1242
- "type": "string",
1243
- "description": "The actual base64 encoded clipboard content",
1244
- "required": true
1245
- }, {
1246
- "name": "contentType",
1247
- "type": "string",
1248
- "description": "The type of the content to get. Plaintext, Image, URL. Android supports only plaintext",
1249
- "required": false
1250
- }, {
1251
- "name": "label",
1252
- "type": "string",
1253
- "description": "Clipboard data label for Android",
1254
- "required": false
1255
- }],
1256
- "returns": {
1257
- "type": "string",
1258
- "name": "response",
1259
- "description": "Response from Appium server"
1260
- }
1261
- }
1262
- },
1263
- "/session/:sessionId/appium/device/get_clipboard": {
1264
- "POST": {
1265
- "command": "getClipboard",
1266
- "description": "Get the content of the system clipboard",
1267
- "ref": "http://appium.io/docs/en/commands/device/clipboard/get-clipboard/",
1268
- "parameters": [{
1269
- "name": "contentType",
1270
- "type": "string",
1271
- "description": "The type of the content to get. Plaintext, Image, URL. Android supports only plaintext",
1272
- "required": false
1273
- }],
1274
- "returns": {
1275
- "type": "string",
1276
- "name": "response",
1277
- "description": "Clipboard content as base64-encoded string or an empty string if the clipboard is empty"
1278
- }
1279
- }
1280
- },
1281
- "/session/:sessionId/touch/perform": {
1282
- "POST": {
1283
- "command": "touchPerform",
1284
- "description": "This functionality is only available from within a native context. 'Touch Perform' works similarly to the other singular touch interactions, except that this allows you to chain together more than one touch action as one command. This is useful because Appium commands are sent over the network and there's latency between commands. This latency can make certain touch interactions impossible because some interactions need to be performed in one sequence. Vertical, for example, requires pressing down, moving to a different y coordinate, and then releasing. For it to work, there can't be a delay between the interactions.",
1285
- "ref": "http://appium.io/docs/en/commands/interactions/touch/touch-perform/",
1286
- "parameters": [{
1287
- "name": "actions",
1288
- "type": "object[]",
1289
- "description": "The type of action to perform (e.g. moveTo, release, press, tap, wait)",
1290
- "required": true
1291
- }],
1292
- "examples": [
1293
- [
1294
- "// do a horizontal swipe by percentage",
1295
- "const startPercentage = 10;",
1296
- "const endPercentage = 90;",
1297
- "const anchorPercentage = 50;",
1298
- "",
1299
- "const { width, height } = driver.getWindowSize();",
1300
- "const anchor = height * anchorPercentage / 100;",
1301
- "const startPoint = width * startPercentage / 100;",
1302
- "const endPoint = width * endPercentage / 100;",
1303
- "driver.touchPerform([",
1304
- " {",
1305
- " action: 'press',",
1306
- " options: {",
1307
- " x: startPoint,",
1308
- " y: anchor,",
1309
- " },",
1310
- " },",
1311
- " {",
1312
- " action: 'wait',",
1313
- " options: {",
1314
- " ms: 100,",
1315
- " },",
1316
- " },",
1317
- " {",
1318
- " action: 'moveTo',",
1319
- " options: {",
1320
- " x: endPoint,",
1321
- " y: anchor,",
1322
- " },",
1323
- " },",
1324
- " {",
1325
- " action: 'release',",
1326
- " options: {},",
1327
- " },",
1328
- "]);"
1329
- ]
1330
- ],
1331
- "support": {
1332
- "android": {
1333
- "UiAutomator": "4.2+"
1334
- },
1335
- "ios": {
1336
- "XCUITest": "9.3+",
1337
- "UIAutomation": "8.0 to 9.3"
1338
- },
1339
- "windows": {
1340
- "Windows": "10+"
1341
- }
1342
- }
1343
- }
1344
- },
1345
- "/session/:sessionId/touch/multi/perform": {
1346
- "POST": {
1347
- "command": "multiTouchPerform",
1348
- "description": "This functionality is only available from within a native context. Perform a multi touch action sequence.",
1349
- "ref": "http://appium.io/docs/en/commands/interactions/touch/multi-touch-perform/",
1350
- "parameters": [{
1351
- "name": "actions",
1352
- "type": "object[]",
1353
- "description": "The type of action to perform (e.g. moveTo, release, press, tap, wait)",
1354
- "required": true
1355
- }],
1356
- "support": {
1357
- "android": {
1358
- "UiAutomator": "4.2+"
1359
- },
1360
- "ios": {
1361
- "XCUITest": "9.3+",
1362
- "UIAutomation": "8.0 to 9.3"
1363
- },
1364
- "windows": {
1365
- "Windows": "10+"
1366
- }
1367
- }
1368
- }
1369
- },
1370
- "/session/:sessionId/appium/execute_driver": {
1371
- "POST": {
1372
- "command": "driverScript",
1373
- "description": "This command allows you to define a webdriverio script in a string and send it to the Appium server to be executed locally to the server itself, thus reducing latency that might otherwise occur along with each command.",
1374
- "ref": "https://github.com/appium/appium/blob/master/docs/en/commands/session/execute-driver.md",
1375
- "parameters": [{
1376
- "name": "script",
1377
- "type": "string",
1378
- "description": "The script to execute. It has access to a 'driver' object which represents a webdriverio session attached to the current server.",
1379
- "required": true
1380
- }, {
1381
- "name": "type",
1382
- "type": "string",
1383
- "description": "The language/framework used in the script. Currently, only 'webdriverio' is supported and is the default.",
1384
- "required": false
1385
- }, {
1386
- "name": "timeout",
1387
- "type": "number",
1388
- "description": "The number of milliseconds the script should be allowed to run before being killed by the Appium server. Defaults to the equivalent of 1 hour.",
1389
- "required": false
1390
- }],
1391
- "returns": {
1392
- "type": "object",
1393
- "name": "result",
1394
- "description": "An object containing two fields: 'result', which is the return value of the script itself, and 'logs', which contains 3 inner fields, 'log', 'warn', and 'error', which hold an array of strings logged by console.log, console.warn, and console.error in the script's execution."
1395
- }
1396
- }
1397
- },
1398
- "/session/:sessionId/appium/events": {
1399
- "POST": {
1400
- "command": "getEvents",
1401
- "description": "Get events stored in appium server.",
1402
- "ref": "https://github.com/appium/appium/blob/master/docs/en/commands/session/events/get-events.md",
1403
- "parameters": [{
1404
- "name": "type",
1405
- "type": "string[]",
1406
- "description": "Get events which are filtered with the type if the type is provided.",
1407
- "required": true
1408
- }],
1409
- "returns": {
1410
- "type": "object",
1411
- "name": "result",
1412
- "description": "A JSON hash of events like `{'commands' => [{'cmd' => 123455, ....}], 'startTime' => 1572954894127, }`."
1413
- }
1414
- }
1415
- },
1416
- "/session/:sessionId/appium/log_event": {
1417
- "POST": {
1418
- "command": "logEvent",
1419
- "description": "Store a custom event.",
1420
- "ref": "https://github.com/appium/appium/blob/master/docs/en/commands/session/events/log-event.md",
1421
- "parameters": [{
1422
- "name": "vendor",
1423
- "type": "string",
1424
- "description": "The name of vendor. It will be `vendor` in `vendor:event`.",
1425
- "required": true
1426
- }, {
1427
- "name": "event",
1428
- "type": "string",
1429
- "description": "The name of event. It will be `event` in `vendor:event`.",
1430
- "required": true
1431
- }]
1432
- }
1433
- },
1434
- "/session/:sessionId/appium/compare_images": {
1435
- "POST": {
1436
- "command": "compareImages",
1437
- "description": "Performs images comparison using OpenCV framework features. It is expected that both OpenCV framework and opencv4nodejs module are installed on the machine where Appium server is running.",
1438
- "ref": "http://appium.io/docs/en/writing-running-appium/image-comparison/",
1439
- "parameters": [{
1440
- "name": "mode",
1441
- "type": "string",
1442
- "description": "One of possible comparison modes: 'matchFeatures', 'getSimilarity', 'matchTemplate'. 'matchFeatures' is by default.",
1443
- "required": true,
1444
- "default": "matchFeatures"
1445
- }, {
1446
- "name": "firstImage",
1447
- "type": "string",
1448
- "description": "An image data. All image formats, that OpenCV library itself accepts, are supported.",
1449
- "required": true
1450
- }, {
1451
- "name": "secondImage",
1452
- "type": "string",
1453
- "description": "An image data. All image formats, that OpenCV library itself accepts, are supported.",
1454
- "required": true
1455
- }, {
1456
- "name": "options",
1457
- "type": "object",
1458
- "description": "The content of this dictionary depends on the actual `mode` value. See the documentation on `appium-support` module for more details. ",
1459
- "required": true,
1460
- "default": {}
1461
- }],
1462
- "returns": {
1463
- "type": "object",
1464
- "name": "result",
1465
- "description": "The content of the resulting dictionary depends on the actual `mode` and `options` values. See the documentation on `appium-support` module for more details."
1466
- }
1467
- }
1468
- }
1469
- }