@wdio/protocols 9.0.0-alpha.78 → 9.0.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.
- package/build/commands/selenium.d.ts +24 -0
- package/build/commands/selenium.d.ts.map +1 -1
- package/build/commands/webdriver.d.ts +6 -6
- package/build/commands/webdriver.d.ts.map +1 -1
- package/build/index.js +5707 -16
- package/build/protocols/selenium.d.ts +35 -0
- package/build/protocols/selenium.d.ts.map +1 -1
- package/build/protocols/webdriver.d.ts +15 -6
- package/build/protocols/webdriver.d.ts.map +1 -1
- package/build/protocols/webdriverBidi.d.ts +120 -4
- package/build/protocols/webdriverBidi.d.ts.map +1 -1
- package/build/types.d.ts +8 -0
- package/build/types.d.ts.map +1 -1
- package/package.json +6 -4
- package/build/commands/appium.js +0 -1
- package/build/commands/chromium.js +0 -1
- package/build/commands/gecko.js +0 -1
- package/build/commands/mjsonwp.js +0 -1
- package/build/commands/saucelabs.js +0 -1
- package/build/commands/selenium.js +0 -1
- package/build/commands/webdriver.js +0 -1
- package/build/protocols/appium.js +0 -2191
- package/build/protocols/chromium.js +0 -530
- package/build/protocols/gecko.js +0 -112
- package/build/protocols/mjsonwp.js +0 -91
- package/build/protocols/saucelabs.js +0 -297
- package/build/protocols/selenium.js +0 -132
- package/build/protocols/webdriver.js +0 -1542
- package/build/protocols/webdriverBidi.js +0 -612
- package/build/types.js +0 -1
- package/tsconfig.prod.json +0 -12
- /package/{LICENSE-MIT → LICENSE} +0 -0
|
@@ -1,2191 +0,0 @@
|
|
|
1
|
-
export default {
|
|
2
|
-
'/session/:sessionId/context': {
|
|
3
|
-
GET: {
|
|
4
|
-
command: 'getContext',
|
|
5
|
-
ref: 'https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md#webviews-and-other-contexts',
|
|
6
|
-
parameters: [],
|
|
7
|
-
returns: {
|
|
8
|
-
type: 'Context',
|
|
9
|
-
name: 'context',
|
|
10
|
-
description: "a string representing the current context or null representing 'no context'",
|
|
11
|
-
},
|
|
12
|
-
},
|
|
13
|
-
POST: {
|
|
14
|
-
command: 'switchContext',
|
|
15
|
-
ref: 'https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md#webviews-and-other-contexts',
|
|
16
|
-
parameters: [
|
|
17
|
-
{
|
|
18
|
-
name: 'name',
|
|
19
|
-
type: 'string',
|
|
20
|
-
description: 'a string representing an available context',
|
|
21
|
-
required: true,
|
|
22
|
-
},
|
|
23
|
-
],
|
|
24
|
-
},
|
|
25
|
-
},
|
|
26
|
-
'/session/:sessionId/contexts': {
|
|
27
|
-
GET: {
|
|
28
|
-
command: 'getContexts',
|
|
29
|
-
ref: 'https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md#webviews-and-other-contexts',
|
|
30
|
-
parameters: [],
|
|
31
|
-
returns: {
|
|
32
|
-
type: 'Context[]',
|
|
33
|
-
name: 'contexts',
|
|
34
|
-
description: "an array of strings representing available contexts, e.g. 'WEBVIEW', or 'NATIVE'",
|
|
35
|
-
},
|
|
36
|
-
},
|
|
37
|
-
},
|
|
38
|
-
'/session/:sessionId/appium/device/shake': {
|
|
39
|
-
POST: {
|
|
40
|
-
command: 'shake',
|
|
41
|
-
description: 'Perform a shake action on the device.',
|
|
42
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/interactions/shake/',
|
|
43
|
-
parameters: [],
|
|
44
|
-
support: {
|
|
45
|
-
ios: {
|
|
46
|
-
XCUITest: '9.3+',
|
|
47
|
-
UIAutomation: '8.0 to 9.3',
|
|
48
|
-
},
|
|
49
|
-
},
|
|
50
|
-
},
|
|
51
|
-
},
|
|
52
|
-
'/session/:sessionId/appium/device/lock': {
|
|
53
|
-
POST: {
|
|
54
|
-
command: 'lock',
|
|
55
|
-
description: 'Lock the device.',
|
|
56
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/interactions/lock/',
|
|
57
|
-
parameters: [
|
|
58
|
-
{
|
|
59
|
-
name: 'seconds',
|
|
60
|
-
type: 'number',
|
|
61
|
-
description: 'how long to lock the screen (iOS only)',
|
|
62
|
-
required: false,
|
|
63
|
-
},
|
|
64
|
-
],
|
|
65
|
-
support: {
|
|
66
|
-
ios: {
|
|
67
|
-
UIAutomation: '8.0 to 9.3',
|
|
68
|
-
},
|
|
69
|
-
android: {
|
|
70
|
-
UiAutomator: '4.2+',
|
|
71
|
-
},
|
|
72
|
-
windows: {
|
|
73
|
-
Windows: '10+',
|
|
74
|
-
},
|
|
75
|
-
},
|
|
76
|
-
},
|
|
77
|
-
},
|
|
78
|
-
'/session/:sessionId/appium/device/unlock': {
|
|
79
|
-
POST: {
|
|
80
|
-
command: 'unlock',
|
|
81
|
-
description: 'Unlock the device.',
|
|
82
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/interactions/unlock/',
|
|
83
|
-
parameters: [],
|
|
84
|
-
support: {
|
|
85
|
-
android: {
|
|
86
|
-
UiAutomator: '4.2+',
|
|
87
|
-
},
|
|
88
|
-
windows: {
|
|
89
|
-
Windows: '10+',
|
|
90
|
-
},
|
|
91
|
-
},
|
|
92
|
-
},
|
|
93
|
-
},
|
|
94
|
-
'/session/:sessionId/appium/device/is_locked': {
|
|
95
|
-
POST: {
|
|
96
|
-
command: 'isLocked',
|
|
97
|
-
description: 'Check whether the device is locked or not.',
|
|
98
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/interactions/is-locked/',
|
|
99
|
-
parameters: [],
|
|
100
|
-
returns: {
|
|
101
|
-
type: 'boolean',
|
|
102
|
-
name: 'isLocked',
|
|
103
|
-
description: 'True if the device is locked, false if not',
|
|
104
|
-
},
|
|
105
|
-
support: {
|
|
106
|
-
android: {
|
|
107
|
-
UiAutomator: '4.2+',
|
|
108
|
-
},
|
|
109
|
-
windows: {
|
|
110
|
-
Windows: '10+',
|
|
111
|
-
},
|
|
112
|
-
},
|
|
113
|
-
},
|
|
114
|
-
},
|
|
115
|
-
'/session/:sessionId/appium/start_recording_screen': {
|
|
116
|
-
POST: {
|
|
117
|
-
command: 'startRecordingScreen',
|
|
118
|
-
description: 'Start recording the screen.',
|
|
119
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/recording-screen/start-recording-screen/',
|
|
120
|
-
parameters: [
|
|
121
|
-
{
|
|
122
|
-
name: 'options',
|
|
123
|
-
type: 'object',
|
|
124
|
-
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)',
|
|
125
|
-
required: false,
|
|
126
|
-
},
|
|
127
|
-
],
|
|
128
|
-
support: {
|
|
129
|
-
ios: {
|
|
130
|
-
XCUITest: '9.3+',
|
|
131
|
-
},
|
|
132
|
-
android: {
|
|
133
|
-
UiAutomator: '4.2+',
|
|
134
|
-
},
|
|
135
|
-
windows: {
|
|
136
|
-
Windows: '10+',
|
|
137
|
-
},
|
|
138
|
-
},
|
|
139
|
-
},
|
|
140
|
-
},
|
|
141
|
-
'/session/:sessionId/appium/stop_recording_screen': {
|
|
142
|
-
POST: {
|
|
143
|
-
command: 'stopRecordingScreen',
|
|
144
|
-
description: 'Stop recording screen',
|
|
145
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/recording-screen/stop-recording-screen/',
|
|
146
|
-
parameters: [
|
|
147
|
-
{
|
|
148
|
-
name: 'remotePath',
|
|
149
|
-
type: 'string',
|
|
150
|
-
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.',
|
|
151
|
-
required: false,
|
|
152
|
-
},
|
|
153
|
-
{
|
|
154
|
-
name: 'username',
|
|
155
|
-
type: 'string',
|
|
156
|
-
description: 'The name of the user for the remote authentication.',
|
|
157
|
-
required: false,
|
|
158
|
-
},
|
|
159
|
-
{
|
|
160
|
-
name: 'password',
|
|
161
|
-
type: 'string',
|
|
162
|
-
description: 'The password for the remote authentication.',
|
|
163
|
-
required: false,
|
|
164
|
-
},
|
|
165
|
-
{
|
|
166
|
-
name: 'method',
|
|
167
|
-
type: 'string',
|
|
168
|
-
description: "The http multipart upload method name. The 'PUT' one is used by default.",
|
|
169
|
-
required: false,
|
|
170
|
-
},
|
|
171
|
-
],
|
|
172
|
-
returns: {
|
|
173
|
-
type: 'string',
|
|
174
|
-
name: 'response',
|
|
175
|
-
description: 'Base64 encoded string. If remote_path is set, the response is empty string',
|
|
176
|
-
},
|
|
177
|
-
support: {
|
|
178
|
-
ios: {
|
|
179
|
-
XCUITest: '9.3+',
|
|
180
|
-
},
|
|
181
|
-
android: {
|
|
182
|
-
UiAutomator: '4.2+',
|
|
183
|
-
},
|
|
184
|
-
windows: {
|
|
185
|
-
Windows: '10+',
|
|
186
|
-
},
|
|
187
|
-
},
|
|
188
|
-
},
|
|
189
|
-
},
|
|
190
|
-
'/session/:sessionId/appium/performanceData/types': {
|
|
191
|
-
POST: {
|
|
192
|
-
command: 'getPerformanceDataTypes',
|
|
193
|
-
description: 'Returns the information types of the system state which is supported to read as like cpu, memory, network traffic, and battery.',
|
|
194
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/performance-data/performance-data-types/',
|
|
195
|
-
parameters: [],
|
|
196
|
-
returns: {
|
|
197
|
-
type: 'string[]',
|
|
198
|
-
name: 'performanceTypes',
|
|
199
|
-
description: 'The available performance data types (cpuinfo|batteryinfo|networkinfo|memoryinfo)',
|
|
200
|
-
},
|
|
201
|
-
support: {
|
|
202
|
-
android: {
|
|
203
|
-
UiAutomator: '4.2+',
|
|
204
|
-
},
|
|
205
|
-
},
|
|
206
|
-
},
|
|
207
|
-
},
|
|
208
|
-
'/session/:sessionId/appium/getPerformanceData': {
|
|
209
|
-
POST: {
|
|
210
|
-
command: 'getPerformanceData',
|
|
211
|
-
description: 'Returns the information of the system state which is supported to read as like cpu, memory, network traffic, and battery.',
|
|
212
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/performance-data/get-performance-data/',
|
|
213
|
-
parameters: [
|
|
214
|
-
{
|
|
215
|
-
name: 'packageName',
|
|
216
|
-
type: 'string',
|
|
217
|
-
description: 'the package name of the application',
|
|
218
|
-
required: true,
|
|
219
|
-
},
|
|
220
|
-
{
|
|
221
|
-
name: 'dataType',
|
|
222
|
-
type: 'string',
|
|
223
|
-
description: 'the type of system state which wants to read. It should be one of the supported performance data types',
|
|
224
|
-
required: true,
|
|
225
|
-
},
|
|
226
|
-
{
|
|
227
|
-
name: 'dataReadTimeout',
|
|
228
|
-
type: 'number',
|
|
229
|
-
description: 'the number of attempts to read',
|
|
230
|
-
required: false,
|
|
231
|
-
},
|
|
232
|
-
],
|
|
233
|
-
returns: {
|
|
234
|
-
type: 'string[]',
|
|
235
|
-
name: 'performanceData',
|
|
236
|
-
description: 'The information type of the system state which is supported to read as like cpu, memory, network traffic, and battery',
|
|
237
|
-
},
|
|
238
|
-
support: {
|
|
239
|
-
android: {
|
|
240
|
-
UiAutomator: '4.2+',
|
|
241
|
-
},
|
|
242
|
-
},
|
|
243
|
-
},
|
|
244
|
-
},
|
|
245
|
-
'/session/:sessionId/appium/device/press_keycode': {
|
|
246
|
-
POST: {
|
|
247
|
-
command: 'pressKeyCode',
|
|
248
|
-
description: 'Press a particular key on the device.',
|
|
249
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/keys/press-keycode/',
|
|
250
|
-
parameters: [
|
|
251
|
-
{
|
|
252
|
-
name: 'keycode',
|
|
253
|
-
type: 'number',
|
|
254
|
-
description: 'keycode to press',
|
|
255
|
-
required: true,
|
|
256
|
-
},
|
|
257
|
-
{
|
|
258
|
-
name: 'metastate',
|
|
259
|
-
type: 'number',
|
|
260
|
-
description: 'meta state to press the keycode with',
|
|
261
|
-
required: false,
|
|
262
|
-
},
|
|
263
|
-
{
|
|
264
|
-
name: 'flags',
|
|
265
|
-
type: 'number',
|
|
266
|
-
description: 'flags for the keypress',
|
|
267
|
-
required: false,
|
|
268
|
-
},
|
|
269
|
-
],
|
|
270
|
-
support: {
|
|
271
|
-
android: {
|
|
272
|
-
UiAutomator: '4.2+',
|
|
273
|
-
},
|
|
274
|
-
},
|
|
275
|
-
},
|
|
276
|
-
},
|
|
277
|
-
'/session/:sessionId/appium/device/long_press_keycode': {
|
|
278
|
-
POST: {
|
|
279
|
-
command: 'longPressKeyCode',
|
|
280
|
-
description: 'Press and hold a particular key code on the device.',
|
|
281
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/keys/long-press-keycode/',
|
|
282
|
-
parameters: [
|
|
283
|
-
{
|
|
284
|
-
name: 'keycode',
|
|
285
|
-
type: 'number',
|
|
286
|
-
description: 'keycode to press on the device',
|
|
287
|
-
required: true,
|
|
288
|
-
},
|
|
289
|
-
{
|
|
290
|
-
name: 'metastate',
|
|
291
|
-
type: 'number',
|
|
292
|
-
description: 'metastate for the keypress',
|
|
293
|
-
required: false,
|
|
294
|
-
},
|
|
295
|
-
{
|
|
296
|
-
name: 'flags',
|
|
297
|
-
type: 'number',
|
|
298
|
-
description: 'flags for the keypress',
|
|
299
|
-
required: false,
|
|
300
|
-
},
|
|
301
|
-
],
|
|
302
|
-
support: {
|
|
303
|
-
android: {
|
|
304
|
-
UiAutomator: '4.2+',
|
|
305
|
-
},
|
|
306
|
-
},
|
|
307
|
-
},
|
|
308
|
-
},
|
|
309
|
-
'/session/:sessionId/appium/device/keyevent': {
|
|
310
|
-
POST: {
|
|
311
|
-
command: 'sendKeyEvent',
|
|
312
|
-
description: 'Send a key code to the device.',
|
|
313
|
-
ref: 'https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints',
|
|
314
|
-
parameters: [
|
|
315
|
-
{
|
|
316
|
-
name: 'keycode',
|
|
317
|
-
type: 'string',
|
|
318
|
-
description: 'keycode to press',
|
|
319
|
-
required: true,
|
|
320
|
-
},
|
|
321
|
-
{
|
|
322
|
-
name: 'metastate',
|
|
323
|
-
type: 'string',
|
|
324
|
-
description: 'meta state to press the keycode with',
|
|
325
|
-
required: false,
|
|
326
|
-
},
|
|
327
|
-
],
|
|
328
|
-
support: {
|
|
329
|
-
android: {
|
|
330
|
-
UiAutomator: '4.2+',
|
|
331
|
-
},
|
|
332
|
-
},
|
|
333
|
-
},
|
|
334
|
-
},
|
|
335
|
-
'/session/:sessionId/rotation': {
|
|
336
|
-
POST: {
|
|
337
|
-
command: 'rotateDevice',
|
|
338
|
-
description: 'Rotate the device in three dimensions.',
|
|
339
|
-
ref: 'https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md#device-rotation',
|
|
340
|
-
parameters: [
|
|
341
|
-
{
|
|
342
|
-
name: 'x',
|
|
343
|
-
type: 'number',
|
|
344
|
-
description: 'x offset to use for the center of the rotate gesture',
|
|
345
|
-
required: true,
|
|
346
|
-
default: 0,
|
|
347
|
-
},
|
|
348
|
-
{
|
|
349
|
-
name: 'y',
|
|
350
|
-
type: 'number',
|
|
351
|
-
description: 'y offset to use for the center of the rotate gesture',
|
|
352
|
-
required: true,
|
|
353
|
-
default: 0,
|
|
354
|
-
},
|
|
355
|
-
{
|
|
356
|
-
name: 'z',
|
|
357
|
-
type: 'number',
|
|
358
|
-
description: 'z offset to use for the center of the rotate gesture',
|
|
359
|
-
required: true,
|
|
360
|
-
default: 0,
|
|
361
|
-
},
|
|
362
|
-
],
|
|
363
|
-
support: {
|
|
364
|
-
ios: {
|
|
365
|
-
UIAutomation: '8.0 to 9.3',
|
|
366
|
-
},
|
|
367
|
-
android: {
|
|
368
|
-
UiAutomator: '4.2+',
|
|
369
|
-
},
|
|
370
|
-
},
|
|
371
|
-
},
|
|
372
|
-
},
|
|
373
|
-
'/session/:sessionId/appium/device/current_activity': {
|
|
374
|
-
GET: {
|
|
375
|
-
command: 'getCurrentActivity',
|
|
376
|
-
description: 'Get the name of the current Android activity.',
|
|
377
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/activity/current-activity/',
|
|
378
|
-
parameters: [],
|
|
379
|
-
returns: {
|
|
380
|
-
type: 'string',
|
|
381
|
-
name: 'activity',
|
|
382
|
-
description: 'Name of the current activity',
|
|
383
|
-
},
|
|
384
|
-
support: {
|
|
385
|
-
android: {
|
|
386
|
-
UiAutomator: '4.2+',
|
|
387
|
-
},
|
|
388
|
-
},
|
|
389
|
-
},
|
|
390
|
-
},
|
|
391
|
-
'/session/:sessionId/appium/device/current_package': {
|
|
392
|
-
GET: {
|
|
393
|
-
command: 'getCurrentPackage',
|
|
394
|
-
description: 'Get the name of the current Android package.',
|
|
395
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/activity/current-package/',
|
|
396
|
-
parameters: [],
|
|
397
|
-
returns: {
|
|
398
|
-
type: 'string',
|
|
399
|
-
name: 'package',
|
|
400
|
-
description: 'Name of the current package',
|
|
401
|
-
},
|
|
402
|
-
support: {
|
|
403
|
-
android: {
|
|
404
|
-
UiAutomator: '4.2+',
|
|
405
|
-
},
|
|
406
|
-
},
|
|
407
|
-
},
|
|
408
|
-
},
|
|
409
|
-
'/session/:sessionId/appium/device/install_app': {
|
|
410
|
-
POST: {
|
|
411
|
-
command: 'installApp',
|
|
412
|
-
description: 'Install the given app onto the device.',
|
|
413
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/install-app/',
|
|
414
|
-
parameters: [
|
|
415
|
-
{
|
|
416
|
-
name: 'appPath',
|
|
417
|
-
type: 'string',
|
|
418
|
-
description: 'path to application .apk file',
|
|
419
|
-
required: true,
|
|
420
|
-
},
|
|
421
|
-
],
|
|
422
|
-
support: {
|
|
423
|
-
ios: {
|
|
424
|
-
XCUITest: '9.3+',
|
|
425
|
-
UIAutomation: '8.0 to 9.3',
|
|
426
|
-
},
|
|
427
|
-
android: {
|
|
428
|
-
UiAutomator: '4.2+',
|
|
429
|
-
},
|
|
430
|
-
},
|
|
431
|
-
},
|
|
432
|
-
},
|
|
433
|
-
'/session/:sessionId/appium/device/activate_app': {
|
|
434
|
-
POST: {
|
|
435
|
-
command: 'activateApp',
|
|
436
|
-
description: 'Activate the given app onto the device',
|
|
437
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/activate-app/',
|
|
438
|
-
parameters: [
|
|
439
|
-
{
|
|
440
|
-
name: 'appId',
|
|
441
|
-
type: 'string',
|
|
442
|
-
description: 'App ID (package ID for Android, bundle ID for iOS)',
|
|
443
|
-
required: true,
|
|
444
|
-
},
|
|
445
|
-
],
|
|
446
|
-
support: {
|
|
447
|
-
ios: {
|
|
448
|
-
XCUITest: '9.3+',
|
|
449
|
-
},
|
|
450
|
-
android: {
|
|
451
|
-
UiAutomator: '4.2+',
|
|
452
|
-
},
|
|
453
|
-
},
|
|
454
|
-
},
|
|
455
|
-
},
|
|
456
|
-
'/session/:sessionId/appium/device/remove_app': {
|
|
457
|
-
POST: {
|
|
458
|
-
command: 'removeApp',
|
|
459
|
-
description: 'Remove an app from the device.',
|
|
460
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/remove-app/',
|
|
461
|
-
parameters: [
|
|
462
|
-
{
|
|
463
|
-
name: 'appId',
|
|
464
|
-
type: 'string',
|
|
465
|
-
description: 'App ID (package ID for Android, bundle ID for iOS)',
|
|
466
|
-
required: true,
|
|
467
|
-
},
|
|
468
|
-
],
|
|
469
|
-
support: {
|
|
470
|
-
ios: {
|
|
471
|
-
XCUITest: '9.3+',
|
|
472
|
-
UIAutomation: '8.0 to 9.3',
|
|
473
|
-
},
|
|
474
|
-
android: {
|
|
475
|
-
UiAutomator: '4.2+',
|
|
476
|
-
},
|
|
477
|
-
},
|
|
478
|
-
},
|
|
479
|
-
},
|
|
480
|
-
'/session/:sessionId/appium/device/terminate_app': {
|
|
481
|
-
POST: {
|
|
482
|
-
command: 'terminateApp',
|
|
483
|
-
description: 'Terminate the given app on the device',
|
|
484
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/terminate-app/',
|
|
485
|
-
parameters: [
|
|
486
|
-
{
|
|
487
|
-
name: 'appId',
|
|
488
|
-
type: 'string',
|
|
489
|
-
description: 'App ID (package ID for Android, bundle ID for iOS)',
|
|
490
|
-
required: true,
|
|
491
|
-
},
|
|
492
|
-
],
|
|
493
|
-
support: {
|
|
494
|
-
ios: {
|
|
495
|
-
XCUITest: '9.3+',
|
|
496
|
-
},
|
|
497
|
-
android: {
|
|
498
|
-
UiAutomator: '4.2+',
|
|
499
|
-
},
|
|
500
|
-
},
|
|
501
|
-
},
|
|
502
|
-
},
|
|
503
|
-
'/session/:sessionId/appium/device/app_installed': {
|
|
504
|
-
POST: {
|
|
505
|
-
command: 'isAppInstalled',
|
|
506
|
-
description: 'Check whether the specified app is installed on the device.',
|
|
507
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/is-app-installed/',
|
|
508
|
-
parameters: [
|
|
509
|
-
{
|
|
510
|
-
name: 'appId',
|
|
511
|
-
type: 'string',
|
|
512
|
-
description: 'App ID (package ID for Android, bundle ID for iOS)',
|
|
513
|
-
required: true,
|
|
514
|
-
},
|
|
515
|
-
],
|
|
516
|
-
returns: {
|
|
517
|
-
type: 'boolean',
|
|
518
|
-
name: 'isAppInstalled',
|
|
519
|
-
description: 'Return true if installed, false if not',
|
|
520
|
-
},
|
|
521
|
-
support: {
|
|
522
|
-
ios: {
|
|
523
|
-
XCUITest: '9.3+',
|
|
524
|
-
UIAutomation: '8.0 to 9.3',
|
|
525
|
-
},
|
|
526
|
-
android: {
|
|
527
|
-
UiAutomator: '4.2+',
|
|
528
|
-
},
|
|
529
|
-
},
|
|
530
|
-
},
|
|
531
|
-
},
|
|
532
|
-
'/session/:sessionId/appium/device/app_state': {
|
|
533
|
-
POST: {
|
|
534
|
-
command: 'queryAppState',
|
|
535
|
-
description: 'Get the given app status on the device',
|
|
536
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/app-state/',
|
|
537
|
-
parameters: [
|
|
538
|
-
{
|
|
539
|
-
name: 'appId',
|
|
540
|
-
type: 'string',
|
|
541
|
-
description: 'App ID (package ID for Android, bundle ID for iOS)',
|
|
542
|
-
required: true,
|
|
543
|
-
},
|
|
544
|
-
],
|
|
545
|
-
returns: {
|
|
546
|
-
type: 'number',
|
|
547
|
-
name: 'appStatus',
|
|
548
|
-
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',
|
|
549
|
-
},
|
|
550
|
-
support: {
|
|
551
|
-
ios: {
|
|
552
|
-
XCUITest: '9.3+',
|
|
553
|
-
},
|
|
554
|
-
android: {
|
|
555
|
-
UiAutomator: '4.2+',
|
|
556
|
-
},
|
|
557
|
-
},
|
|
558
|
-
},
|
|
559
|
-
},
|
|
560
|
-
'/session/:sessionId/appium/device/hide_keyboard': {
|
|
561
|
-
POST: {
|
|
562
|
-
command: 'hideKeyboard',
|
|
563
|
-
description: 'Hide soft keyboard.',
|
|
564
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/keys/hide-keyboard/',
|
|
565
|
-
parameters: [
|
|
566
|
-
{
|
|
567
|
-
name: 'strategy',
|
|
568
|
-
type: 'string',
|
|
569
|
-
description: "hide keyboard strategy (UIAutomation only), available strategies - 'press', 'pressKey', 'swipeDown', 'tapOut', 'tapOutside', 'default'",
|
|
570
|
-
required: false,
|
|
571
|
-
},
|
|
572
|
-
{
|
|
573
|
-
name: 'key',
|
|
574
|
-
type: 'string',
|
|
575
|
-
description: "key value if strategy is 'pressKey'",
|
|
576
|
-
required: false,
|
|
577
|
-
},
|
|
578
|
-
{
|
|
579
|
-
name: 'keyCode',
|
|
580
|
-
type: 'string',
|
|
581
|
-
description: "key code if strategy is 'pressKey'",
|
|
582
|
-
required: false,
|
|
583
|
-
},
|
|
584
|
-
{
|
|
585
|
-
name: 'keyName',
|
|
586
|
-
type: 'string',
|
|
587
|
-
description: "key name if strategy is 'pressKey'",
|
|
588
|
-
required: false,
|
|
589
|
-
},
|
|
590
|
-
],
|
|
591
|
-
support: {
|
|
592
|
-
ios: {
|
|
593
|
-
XCUITest: '9.3+',
|
|
594
|
-
UIAutomation: '8.0 to 9.3',
|
|
595
|
-
},
|
|
596
|
-
android: {
|
|
597
|
-
UiAutomator: '4.2+',
|
|
598
|
-
},
|
|
599
|
-
windows: {
|
|
600
|
-
Windows: '10+',
|
|
601
|
-
},
|
|
602
|
-
},
|
|
603
|
-
},
|
|
604
|
-
},
|
|
605
|
-
'/session/:sessionId/appium/device/is_keyboard_shown': {
|
|
606
|
-
GET: {
|
|
607
|
-
command: 'isKeyboardShown',
|
|
608
|
-
description: 'Whether or not the soft keyboard is shown.',
|
|
609
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/keys/is-keyboard-shown/',
|
|
610
|
-
parameters: [],
|
|
611
|
-
returns: {
|
|
612
|
-
type: 'boolean',
|
|
613
|
-
name: 'isKeyboardShown',
|
|
614
|
-
description: 'True if the keyboard is shown',
|
|
615
|
-
},
|
|
616
|
-
support: {
|
|
617
|
-
ios: {
|
|
618
|
-
XCUITest: '9.3+',
|
|
619
|
-
UIAutomation: '8.0 to 9.3',
|
|
620
|
-
},
|
|
621
|
-
android: {
|
|
622
|
-
UiAutomator: '4.2+',
|
|
623
|
-
},
|
|
624
|
-
windows: {
|
|
625
|
-
Windows: '10+',
|
|
626
|
-
},
|
|
627
|
-
},
|
|
628
|
-
},
|
|
629
|
-
},
|
|
630
|
-
'/session/:sessionId/appium/device/push_file': {
|
|
631
|
-
POST: {
|
|
632
|
-
command: 'pushFile',
|
|
633
|
-
description: 'Place a file onto the device in a particular place.',
|
|
634
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/files/push-file/',
|
|
635
|
-
parameters: [
|
|
636
|
-
{
|
|
637
|
-
name: 'path',
|
|
638
|
-
type: 'string',
|
|
639
|
-
description: 'path to install the data to',
|
|
640
|
-
required: true,
|
|
641
|
-
},
|
|
642
|
-
{
|
|
643
|
-
name: 'data',
|
|
644
|
-
type: 'string',
|
|
645
|
-
description: 'contents of file in base64',
|
|
646
|
-
required: true,
|
|
647
|
-
},
|
|
648
|
-
],
|
|
649
|
-
support: {
|
|
650
|
-
ios: {
|
|
651
|
-
XCUITest: '9.3+',
|
|
652
|
-
UIAutomation: '8.0 to 9.3',
|
|
653
|
-
},
|
|
654
|
-
android: {
|
|
655
|
-
UiAutomator: '4.2+',
|
|
656
|
-
},
|
|
657
|
-
windows: {
|
|
658
|
-
Windows: '10+',
|
|
659
|
-
},
|
|
660
|
-
},
|
|
661
|
-
},
|
|
662
|
-
},
|
|
663
|
-
'/session/:sessionId/appium/device/pull_file': {
|
|
664
|
-
POST: {
|
|
665
|
-
command: 'pullFile',
|
|
666
|
-
description: "Retrieve a file from the device's file system.",
|
|
667
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/files/pull-file/',
|
|
668
|
-
parameters: [
|
|
669
|
-
{
|
|
670
|
-
name: 'path',
|
|
671
|
-
type: 'string',
|
|
672
|
-
description: 'path on the device to pull file from',
|
|
673
|
-
required: true,
|
|
674
|
-
},
|
|
675
|
-
],
|
|
676
|
-
support: {
|
|
677
|
-
ios: {
|
|
678
|
-
XCUITest: '9.3+',
|
|
679
|
-
UIAutomation: '8.0 to 9.3',
|
|
680
|
-
},
|
|
681
|
-
android: {
|
|
682
|
-
UiAutomator: '4.2+',
|
|
683
|
-
},
|
|
684
|
-
windows: {
|
|
685
|
-
Windows: '10+',
|
|
686
|
-
},
|
|
687
|
-
},
|
|
688
|
-
returns: {
|
|
689
|
-
type: 'string',
|
|
690
|
-
name: 'response',
|
|
691
|
-
description: 'Contents of file in base64',
|
|
692
|
-
},
|
|
693
|
-
},
|
|
694
|
-
},
|
|
695
|
-
'/session/:sessionId/appium/device/pull_folder': {
|
|
696
|
-
POST: {
|
|
697
|
-
command: 'pullFolder',
|
|
698
|
-
description: "Retrieve a folder from the device's file system.",
|
|
699
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/files/pull-folder/',
|
|
700
|
-
parameters: [
|
|
701
|
-
{
|
|
702
|
-
name: 'path',
|
|
703
|
-
type: 'string',
|
|
704
|
-
description: 'path to an entire folder on the device',
|
|
705
|
-
required: true,
|
|
706
|
-
},
|
|
707
|
-
],
|
|
708
|
-
support: {
|
|
709
|
-
ios: {
|
|
710
|
-
XCUITest: '9.3+',
|
|
711
|
-
UIAutomation: '8.0 to 9.3',
|
|
712
|
-
},
|
|
713
|
-
android: {
|
|
714
|
-
UiAutomator: '4.2+',
|
|
715
|
-
},
|
|
716
|
-
windows: {
|
|
717
|
-
Windows: '10+',
|
|
718
|
-
},
|
|
719
|
-
},
|
|
720
|
-
},
|
|
721
|
-
},
|
|
722
|
-
'/session/:sessionId/appium/device/toggle_airplane_mode': {
|
|
723
|
-
POST: {
|
|
724
|
-
command: 'toggleAirplaneMode',
|
|
725
|
-
description: 'Toggle airplane mode on device.',
|
|
726
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/toggle-airplane-mode/',
|
|
727
|
-
parameters: [],
|
|
728
|
-
support: {
|
|
729
|
-
android: {
|
|
730
|
-
UiAutomator: '4.2+',
|
|
731
|
-
},
|
|
732
|
-
},
|
|
733
|
-
},
|
|
734
|
-
},
|
|
735
|
-
'/session/:sessionId/appium/device/toggle_data': {
|
|
736
|
-
POST: {
|
|
737
|
-
command: 'toggleData',
|
|
738
|
-
description: 'Switch the state of data service.',
|
|
739
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/toggle-data/',
|
|
740
|
-
parameters: [],
|
|
741
|
-
support: {
|
|
742
|
-
android: {
|
|
743
|
-
UiAutomator: '4.2+',
|
|
744
|
-
},
|
|
745
|
-
},
|
|
746
|
-
},
|
|
747
|
-
},
|
|
748
|
-
'/session/:sessionId/appium/device/toggle_wifi': {
|
|
749
|
-
POST: {
|
|
750
|
-
command: 'toggleWiFi',
|
|
751
|
-
description: 'Switch the state of the wifi service.',
|
|
752
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/toggle-wifi/',
|
|
753
|
-
parameters: [],
|
|
754
|
-
support: {
|
|
755
|
-
android: {
|
|
756
|
-
UiAutomator: '4.2+',
|
|
757
|
-
},
|
|
758
|
-
},
|
|
759
|
-
},
|
|
760
|
-
},
|
|
761
|
-
'/session/:sessionId/appium/device/toggle_location_services': {
|
|
762
|
-
POST: {
|
|
763
|
-
command: 'toggleLocationServices',
|
|
764
|
-
description: 'Switch the state of the location service.',
|
|
765
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/toggle-location-services/',
|
|
766
|
-
parameters: [],
|
|
767
|
-
support: {
|
|
768
|
-
android: {
|
|
769
|
-
UiAutomator: '4.2+',
|
|
770
|
-
},
|
|
771
|
-
},
|
|
772
|
-
},
|
|
773
|
-
},
|
|
774
|
-
'/session/:sessionId/appium/device/network_speed': {
|
|
775
|
-
POST: {
|
|
776
|
-
command: 'toggleNetworkSpeed',
|
|
777
|
-
description: 'Set network speed (Emulator only)',
|
|
778
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/network-speed/',
|
|
779
|
-
parameters: [
|
|
780
|
-
{
|
|
781
|
-
name: 'netspeed',
|
|
782
|
-
type: 'string',
|
|
783
|
-
description: "Network type - 'full','gsm', 'edge', 'hscsd', 'gprs', 'umts', 'hsdpa', 'lte', 'evdo'",
|
|
784
|
-
required: true,
|
|
785
|
-
},
|
|
786
|
-
],
|
|
787
|
-
support: {
|
|
788
|
-
android: {
|
|
789
|
-
UiAutomator: '4.2+',
|
|
790
|
-
},
|
|
791
|
-
},
|
|
792
|
-
},
|
|
793
|
-
},
|
|
794
|
-
'/session/:sessionId/appium/device/open_notifications': {
|
|
795
|
-
POST: {
|
|
796
|
-
command: 'openNotifications',
|
|
797
|
-
description: 'Open Android notifications (Emulator only).',
|
|
798
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/system/open-notifications/',
|
|
799
|
-
parameters: [],
|
|
800
|
-
support: {
|
|
801
|
-
android: {
|
|
802
|
-
UiAutomator: '4.2+',
|
|
803
|
-
},
|
|
804
|
-
},
|
|
805
|
-
},
|
|
806
|
-
},
|
|
807
|
-
'/session/:sessionId/appium/device/start_activity': {
|
|
808
|
-
POST: {
|
|
809
|
-
command: 'startActivity',
|
|
810
|
-
description: 'Start an Android activity by providing package name and activity name.',
|
|
811
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/activity/start-activity/',
|
|
812
|
-
parameters: [
|
|
813
|
-
{
|
|
814
|
-
name: 'appPackage',
|
|
815
|
-
type: 'string',
|
|
816
|
-
description: 'name of app',
|
|
817
|
-
required: true,
|
|
818
|
-
},
|
|
819
|
-
{
|
|
820
|
-
name: 'appActivity',
|
|
821
|
-
type: 'string',
|
|
822
|
-
description: 'name of activity',
|
|
823
|
-
required: true,
|
|
824
|
-
},
|
|
825
|
-
{
|
|
826
|
-
name: 'appWaitPackage',
|
|
827
|
-
type: 'string',
|
|
828
|
-
description: 'name of app to wait for',
|
|
829
|
-
required: false,
|
|
830
|
-
},
|
|
831
|
-
{
|
|
832
|
-
name: 'appWaitActivity',
|
|
833
|
-
type: 'string',
|
|
834
|
-
description: 'name of activity to wait for',
|
|
835
|
-
required: false,
|
|
836
|
-
},
|
|
837
|
-
{
|
|
838
|
-
name: 'intentAction',
|
|
839
|
-
type: 'string',
|
|
840
|
-
description: 'intent action which will be used to start activity',
|
|
841
|
-
required: false,
|
|
842
|
-
default: 'android.intent.action.MAIN',
|
|
843
|
-
},
|
|
844
|
-
{
|
|
845
|
-
name: 'intentCategory',
|
|
846
|
-
type: 'string',
|
|
847
|
-
description: 'intent category which will be used to start activity',
|
|
848
|
-
required: false,
|
|
849
|
-
default: 'android.intent.category.LAUNCHER',
|
|
850
|
-
},
|
|
851
|
-
{
|
|
852
|
-
name: 'intentFlags',
|
|
853
|
-
type: 'string',
|
|
854
|
-
description: 'flags that will be used to start activity',
|
|
855
|
-
required: false,
|
|
856
|
-
default: '0x10200000',
|
|
857
|
-
},
|
|
858
|
-
{
|
|
859
|
-
name: 'optionalIntentArguments',
|
|
860
|
-
type: 'string',
|
|
861
|
-
description: 'additional intent arguments that will be used to start activity',
|
|
862
|
-
required: false,
|
|
863
|
-
},
|
|
864
|
-
{
|
|
865
|
-
name: 'dontStopAppOnReset',
|
|
866
|
-
type: 'string',
|
|
867
|
-
description: 'doesn’t stop the process of the app under test, before starting the app using adb',
|
|
868
|
-
required: false,
|
|
869
|
-
},
|
|
870
|
-
],
|
|
871
|
-
support: {
|
|
872
|
-
android: {
|
|
873
|
-
UiAutomator: '4.2+',
|
|
874
|
-
},
|
|
875
|
-
},
|
|
876
|
-
},
|
|
877
|
-
},
|
|
878
|
-
'/session/:sessionId/appium/device/system_bars': {
|
|
879
|
-
GET: {
|
|
880
|
-
command: 'getSystemBars',
|
|
881
|
-
description: 'Retrieve visibility and bounds information of the status and navigation bars.',
|
|
882
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/system/system-bars/',
|
|
883
|
-
parameters: [],
|
|
884
|
-
returns: {
|
|
885
|
-
type: 'object[]',
|
|
886
|
-
name: 'systemBars',
|
|
887
|
-
description: 'Information about visibility and bounds of status and navigation bar',
|
|
888
|
-
},
|
|
889
|
-
support: {
|
|
890
|
-
android: {
|
|
891
|
-
UiAutomator: '4.2+',
|
|
892
|
-
},
|
|
893
|
-
},
|
|
894
|
-
},
|
|
895
|
-
},
|
|
896
|
-
'/session/:sessionId/appium/device/system_time': {
|
|
897
|
-
GET: {
|
|
898
|
-
command: 'getDeviceTime',
|
|
899
|
-
description: 'Get the time on the device.',
|
|
900
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/system/system-time/',
|
|
901
|
-
parameters: [],
|
|
902
|
-
returns: {
|
|
903
|
-
type: 'string',
|
|
904
|
-
name: 'time',
|
|
905
|
-
description: 'Time on the device',
|
|
906
|
-
},
|
|
907
|
-
support: {
|
|
908
|
-
ios: {
|
|
909
|
-
XCUITest: '9.3+',
|
|
910
|
-
UIAutomation: '8.0 to 9.3',
|
|
911
|
-
},
|
|
912
|
-
android: {
|
|
913
|
-
UiAutomator: '4.2+',
|
|
914
|
-
},
|
|
915
|
-
},
|
|
916
|
-
},
|
|
917
|
-
},
|
|
918
|
-
'/session/:sessionId/appium/device/display_density': {
|
|
919
|
-
GET: {
|
|
920
|
-
command: 'getDisplayDensity',
|
|
921
|
-
description: 'Get display density from device.',
|
|
922
|
-
ref: 'https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints',
|
|
923
|
-
parameters: [],
|
|
924
|
-
returns: {
|
|
925
|
-
type: '*',
|
|
926
|
-
name: 'displayDensity',
|
|
927
|
-
},
|
|
928
|
-
support: {
|
|
929
|
-
android: {
|
|
930
|
-
UiAutomator: '4.2+',
|
|
931
|
-
},
|
|
932
|
-
},
|
|
933
|
-
},
|
|
934
|
-
},
|
|
935
|
-
'/session/:sessionId/appium/simulator/touch_id': {
|
|
936
|
-
POST: {
|
|
937
|
-
command: 'touchId',
|
|
938
|
-
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](https://appium.github.io/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.',
|
|
939
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/simulator/touch-id/',
|
|
940
|
-
parameters: [
|
|
941
|
-
{
|
|
942
|
-
name: 'match',
|
|
943
|
-
type: 'boolean',
|
|
944
|
-
description: 'are we simulating a successful touch (true) or a failed touch (false)',
|
|
945
|
-
required: true,
|
|
946
|
-
},
|
|
947
|
-
],
|
|
948
|
-
support: {
|
|
949
|
-
ios: {
|
|
950
|
-
XCUITest: '9.3+',
|
|
951
|
-
},
|
|
952
|
-
},
|
|
953
|
-
},
|
|
954
|
-
},
|
|
955
|
-
'/session/:sessionId/appium/simulator/toggle_touch_id_enrollment': {
|
|
956
|
-
POST: {
|
|
957
|
-
command: 'toggleEnrollTouchId',
|
|
958
|
-
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.",
|
|
959
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/simulator/toggle-touch-id-enrollment/',
|
|
960
|
-
parameters: [
|
|
961
|
-
{
|
|
962
|
-
name: 'enabled',
|
|
963
|
-
type: 'boolean',
|
|
964
|
-
description: 'equals to true if TouchID enrollment should be enabled',
|
|
965
|
-
required: false,
|
|
966
|
-
default: true,
|
|
967
|
-
},
|
|
968
|
-
],
|
|
969
|
-
support: {
|
|
970
|
-
ios: {
|
|
971
|
-
XCUITest: '9.3+',
|
|
972
|
-
},
|
|
973
|
-
},
|
|
974
|
-
},
|
|
975
|
-
},
|
|
976
|
-
'/session/:sessionId/appium/app/launch': {
|
|
977
|
-
POST: {
|
|
978
|
-
command: 'launchApp',
|
|
979
|
-
description: 'Launch an app on device.',
|
|
980
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/launch-app/',
|
|
981
|
-
deprecated: 'For iOS, utilize `driver.execute(\'mobile: launchApp\', { ... })`, and for Android, make use of `driver.execute(\'mobile: activateApp\', { ... })`.',
|
|
982
|
-
parameters: [],
|
|
983
|
-
support: {
|
|
984
|
-
ios: {
|
|
985
|
-
XCUITest: '9.3+',
|
|
986
|
-
UIAutomation: '8.0 to 9.3',
|
|
987
|
-
},
|
|
988
|
-
android: {
|
|
989
|
-
UiAutomator: '4.2+',
|
|
990
|
-
},
|
|
991
|
-
},
|
|
992
|
-
},
|
|
993
|
-
},
|
|
994
|
-
'/session/:sessionId/appium/app/close': {
|
|
995
|
-
POST: {
|
|
996
|
-
command: 'closeApp',
|
|
997
|
-
description: 'Close an app on device.',
|
|
998
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/close-app/',
|
|
999
|
-
deprecated: 'Use `driver.execute(\'mobile: terminateApp\', { ... })` instead',
|
|
1000
|
-
parameters: [],
|
|
1001
|
-
support: {
|
|
1002
|
-
ios: {
|
|
1003
|
-
XCUITest: '9.3+',
|
|
1004
|
-
UIAutomation: '8.0 to 9.3',
|
|
1005
|
-
},
|
|
1006
|
-
android: {
|
|
1007
|
-
UiAutomator: '4.2+',
|
|
1008
|
-
},
|
|
1009
|
-
},
|
|
1010
|
-
},
|
|
1011
|
-
},
|
|
1012
|
-
'/session/:sessionId/appium/app/background': {
|
|
1013
|
-
POST: {
|
|
1014
|
-
command: 'background',
|
|
1015
|
-
description: 'Send the currently running app for this session to the background.',
|
|
1016
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/background-app/',
|
|
1017
|
-
deprecated: 'Use `driver.execute(\'mobile: backgroundApp\', { ... })` instead',
|
|
1018
|
-
parameters: [
|
|
1019
|
-
{
|
|
1020
|
-
name: 'seconds',
|
|
1021
|
-
type: '(number|null)',
|
|
1022
|
-
description: "timeout to restore app, if 'null' app won't be restored",
|
|
1023
|
-
required: true,
|
|
1024
|
-
default: 'null',
|
|
1025
|
-
},
|
|
1026
|
-
],
|
|
1027
|
-
support: {
|
|
1028
|
-
ios: {
|
|
1029
|
-
XCUITest: '9.3+',
|
|
1030
|
-
UIAutomation: '8.0 to 9.3',
|
|
1031
|
-
},
|
|
1032
|
-
android: {
|
|
1033
|
-
UiAutomator: '4.2+',
|
|
1034
|
-
},
|
|
1035
|
-
},
|
|
1036
|
-
},
|
|
1037
|
-
},
|
|
1038
|
-
'/session/:sessionId/appium/app/end_test_coverage': {
|
|
1039
|
-
POST: {
|
|
1040
|
-
command: 'endCoverage',
|
|
1041
|
-
description: 'Get test coverage data.',
|
|
1042
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/end-test-coverage/',
|
|
1043
|
-
parameters: [
|
|
1044
|
-
{
|
|
1045
|
-
name: 'intent',
|
|
1046
|
-
type: 'string',
|
|
1047
|
-
description: 'intent to broadcast',
|
|
1048
|
-
required: true,
|
|
1049
|
-
},
|
|
1050
|
-
{
|
|
1051
|
-
name: 'path',
|
|
1052
|
-
type: 'string',
|
|
1053
|
-
description: 'path to .ec file',
|
|
1054
|
-
required: true,
|
|
1055
|
-
},
|
|
1056
|
-
],
|
|
1057
|
-
support: {
|
|
1058
|
-
android: {
|
|
1059
|
-
UiAutomator: '4.2+',
|
|
1060
|
-
},
|
|
1061
|
-
},
|
|
1062
|
-
},
|
|
1063
|
-
},
|
|
1064
|
-
'/session/:sessionId/appium/app/strings': {
|
|
1065
|
-
POST: {
|
|
1066
|
-
command: 'getStrings',
|
|
1067
|
-
description: 'Get app strings.',
|
|
1068
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/app/get-app-strings/',
|
|
1069
|
-
parameters: [
|
|
1070
|
-
{
|
|
1071
|
-
name: 'language',
|
|
1072
|
-
type: 'string',
|
|
1073
|
-
description: 'language code',
|
|
1074
|
-
required: false,
|
|
1075
|
-
},
|
|
1076
|
-
{
|
|
1077
|
-
name: 'stringFile',
|
|
1078
|
-
type: 'string',
|
|
1079
|
-
description: 'path to the string file',
|
|
1080
|
-
required: false,
|
|
1081
|
-
},
|
|
1082
|
-
],
|
|
1083
|
-
returns: {
|
|
1084
|
-
type: 'object',
|
|
1085
|
-
name: 'appStrings',
|
|
1086
|
-
description: 'all defined Strings from an app for the specified language and strings filename',
|
|
1087
|
-
},
|
|
1088
|
-
support: {
|
|
1089
|
-
ios: {
|
|
1090
|
-
XCUITest: '9.3+',
|
|
1091
|
-
UIAutomation: '8.0 to 9.3',
|
|
1092
|
-
},
|
|
1093
|
-
android: {
|
|
1094
|
-
UiAutomator: '4.2+',
|
|
1095
|
-
},
|
|
1096
|
-
},
|
|
1097
|
-
},
|
|
1098
|
-
},
|
|
1099
|
-
'/session/:sessionId/appium/element/:elementId/value': {
|
|
1100
|
-
POST: {
|
|
1101
|
-
command: 'setValueImmediate',
|
|
1102
|
-
ref: 'https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints',
|
|
1103
|
-
variables: [
|
|
1104
|
-
{
|
|
1105
|
-
name: 'elementId',
|
|
1106
|
-
description: 'the id of an element returned in a previous call to Find Element(s)',
|
|
1107
|
-
},
|
|
1108
|
-
],
|
|
1109
|
-
parameters: [
|
|
1110
|
-
{
|
|
1111
|
-
name: 'text',
|
|
1112
|
-
type: 'string',
|
|
1113
|
-
description: 'text to set to an element',
|
|
1114
|
-
required: true,
|
|
1115
|
-
},
|
|
1116
|
-
],
|
|
1117
|
-
support: {
|
|
1118
|
-
ios: {
|
|
1119
|
-
XCUITest: '9.3+',
|
|
1120
|
-
},
|
|
1121
|
-
android: {
|
|
1122
|
-
UiAutomator: '4.2+',
|
|
1123
|
-
},
|
|
1124
|
-
},
|
|
1125
|
-
},
|
|
1126
|
-
},
|
|
1127
|
-
'/session/:sessionId/appium/element/:elementId/replace_value': {
|
|
1128
|
-
POST: {
|
|
1129
|
-
command: 'replaceValue',
|
|
1130
|
-
description: 'Replace the value to element directly.',
|
|
1131
|
-
ref: 'https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints',
|
|
1132
|
-
variables: [
|
|
1133
|
-
{
|
|
1134
|
-
name: 'elementId',
|
|
1135
|
-
description: 'the id of an element returned in a previous call to Find Element(s)',
|
|
1136
|
-
},
|
|
1137
|
-
],
|
|
1138
|
-
parameters: [
|
|
1139
|
-
{
|
|
1140
|
-
name: 'value',
|
|
1141
|
-
type: 'string',
|
|
1142
|
-
description: 'value to replace on element',
|
|
1143
|
-
required: true,
|
|
1144
|
-
},
|
|
1145
|
-
],
|
|
1146
|
-
support: {
|
|
1147
|
-
ios: {
|
|
1148
|
-
XCUITest: '9.3+',
|
|
1149
|
-
UIAutomation: '8.0 to 9.3',
|
|
1150
|
-
},
|
|
1151
|
-
android: {
|
|
1152
|
-
UiAutomator: '4.2+',
|
|
1153
|
-
},
|
|
1154
|
-
},
|
|
1155
|
-
},
|
|
1156
|
-
},
|
|
1157
|
-
'/session/:sessionId/appium/settings': {
|
|
1158
|
-
GET: {
|
|
1159
|
-
command: 'getSettings',
|
|
1160
|
-
description: 'Retrieve the current settings on the device.',
|
|
1161
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/session/settings/get-settings/',
|
|
1162
|
-
parameters: [],
|
|
1163
|
-
returns: {
|
|
1164
|
-
type: 'object',
|
|
1165
|
-
name: 'settings',
|
|
1166
|
-
description: 'JSON hash of all the currently specified settings, see Settings API',
|
|
1167
|
-
},
|
|
1168
|
-
support: {
|
|
1169
|
-
ios: {
|
|
1170
|
-
XCUITest: '9.3+',
|
|
1171
|
-
UIAutomation: '8.0 to 9.3',
|
|
1172
|
-
},
|
|
1173
|
-
android: {
|
|
1174
|
-
UiAutomator: '4.2+',
|
|
1175
|
-
},
|
|
1176
|
-
windows: {
|
|
1177
|
-
Windows: '10+',
|
|
1178
|
-
},
|
|
1179
|
-
},
|
|
1180
|
-
},
|
|
1181
|
-
POST: {
|
|
1182
|
-
command: 'updateSettings',
|
|
1183
|
-
description: 'Update the current setting on the device.',
|
|
1184
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/session/settings/update-settings/',
|
|
1185
|
-
parameters: [
|
|
1186
|
-
{
|
|
1187
|
-
name: 'settings',
|
|
1188
|
-
type: 'object',
|
|
1189
|
-
description: 'key/value object with settings to update',
|
|
1190
|
-
required: true,
|
|
1191
|
-
},
|
|
1192
|
-
],
|
|
1193
|
-
support: {
|
|
1194
|
-
ios: {
|
|
1195
|
-
XCUITest: '9.3+',
|
|
1196
|
-
UIAutomation: '8.0 to 9.3',
|
|
1197
|
-
},
|
|
1198
|
-
android: {
|
|
1199
|
-
UiAutomator: '4.2+',
|
|
1200
|
-
},
|
|
1201
|
-
windows: {
|
|
1202
|
-
Windows: '10+',
|
|
1203
|
-
},
|
|
1204
|
-
},
|
|
1205
|
-
},
|
|
1206
|
-
},
|
|
1207
|
-
'/session/:sessionId/appium/receive_async_response': {
|
|
1208
|
-
POST: {
|
|
1209
|
-
command: 'receiveAsyncResponse',
|
|
1210
|
-
description: 'Callback url for asynchronous execution of JavaScript.',
|
|
1211
|
-
ref: 'https://github.com/appium/appium-base-driver/blob/master/docs/mjsonwp/protocol-methods.md#appium-extension-endpoints',
|
|
1212
|
-
parameters: [
|
|
1213
|
-
{
|
|
1214
|
-
name: 'response',
|
|
1215
|
-
type: 'object',
|
|
1216
|
-
description: 'response to receive on device',
|
|
1217
|
-
required: true,
|
|
1218
|
-
},
|
|
1219
|
-
],
|
|
1220
|
-
support: {
|
|
1221
|
-
ios: {
|
|
1222
|
-
XCUITest: '9.3+',
|
|
1223
|
-
UIAutomation: '8.0 to 9.3',
|
|
1224
|
-
}
|
|
1225
|
-
},
|
|
1226
|
-
},
|
|
1227
|
-
},
|
|
1228
|
-
'/session/:sessionId/appium/device/gsm_call': {
|
|
1229
|
-
POST: {
|
|
1230
|
-
command: 'gsmCall',
|
|
1231
|
-
description: 'Make GSM call (Emulator only).',
|
|
1232
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/gsm-call/',
|
|
1233
|
-
parameters: [
|
|
1234
|
-
{
|
|
1235
|
-
name: 'phoneNumber',
|
|
1236
|
-
type: 'string',
|
|
1237
|
-
description: 'the phone number to call to',
|
|
1238
|
-
required: true,
|
|
1239
|
-
},
|
|
1240
|
-
{
|
|
1241
|
-
name: 'action',
|
|
1242
|
-
type: 'string',
|
|
1243
|
-
description: "The action - 'call', 'accept', 'cancel', 'hold'",
|
|
1244
|
-
required: true,
|
|
1245
|
-
},
|
|
1246
|
-
],
|
|
1247
|
-
support: {
|
|
1248
|
-
android: {
|
|
1249
|
-
UiAutomator: '4.2+',
|
|
1250
|
-
},
|
|
1251
|
-
},
|
|
1252
|
-
},
|
|
1253
|
-
},
|
|
1254
|
-
'/session/:sessionId/appium/device/gsm_signal': {
|
|
1255
|
-
POST: {
|
|
1256
|
-
command: 'gsmSignal',
|
|
1257
|
-
description: 'Set GSM signal strength (Emulator only).',
|
|
1258
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/gsm-signal/',
|
|
1259
|
-
parameters: [
|
|
1260
|
-
{
|
|
1261
|
-
name: 'signalStrength',
|
|
1262
|
-
type: 'string',
|
|
1263
|
-
description: 'signal strength in the range [0, 4]',
|
|
1264
|
-
required: true,
|
|
1265
|
-
},
|
|
1266
|
-
{
|
|
1267
|
-
name: 'signalStrengh',
|
|
1268
|
-
type: 'string',
|
|
1269
|
-
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).',
|
|
1270
|
-
required: false,
|
|
1271
|
-
},
|
|
1272
|
-
],
|
|
1273
|
-
support: {
|
|
1274
|
-
android: {
|
|
1275
|
-
UiAutomator: '4.2+',
|
|
1276
|
-
},
|
|
1277
|
-
},
|
|
1278
|
-
},
|
|
1279
|
-
},
|
|
1280
|
-
'/session/:sessionId/appium/device/power_capacity': {
|
|
1281
|
-
POST: {
|
|
1282
|
-
command: 'powerCapacity',
|
|
1283
|
-
description: 'Set the battery percentage (Emulator only).',
|
|
1284
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/emulator/power_capacity/',
|
|
1285
|
-
parameters: [
|
|
1286
|
-
{
|
|
1287
|
-
name: 'percent',
|
|
1288
|
-
type: 'number',
|
|
1289
|
-
description: 'percentage value in range [0, 100]',
|
|
1290
|
-
required: true,
|
|
1291
|
-
},
|
|
1292
|
-
],
|
|
1293
|
-
support: {
|
|
1294
|
-
android: {
|
|
1295
|
-
UiAutomator: '4.2+',
|
|
1296
|
-
},
|
|
1297
|
-
},
|
|
1298
|
-
},
|
|
1299
|
-
},
|
|
1300
|
-
'/session/:sessionId/appium/device/power_ac': {
|
|
1301
|
-
POST: {
|
|
1302
|
-
command: 'powerAC',
|
|
1303
|
-
description: 'Set the state of the battery charger to connected or not (Emulator only).',
|
|
1304
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/emulator/power_ac/',
|
|
1305
|
-
parameters: [
|
|
1306
|
-
{
|
|
1307
|
-
name: 'state',
|
|
1308
|
-
type: 'string',
|
|
1309
|
-
description: 'set the state. on or off',
|
|
1310
|
-
required: true,
|
|
1311
|
-
},
|
|
1312
|
-
],
|
|
1313
|
-
support: {
|
|
1314
|
-
android: {
|
|
1315
|
-
UiAutomator: '4.2+',
|
|
1316
|
-
},
|
|
1317
|
-
},
|
|
1318
|
-
},
|
|
1319
|
-
},
|
|
1320
|
-
'/session/:sessionId/appium/device/gsm_voice': {
|
|
1321
|
-
POST: {
|
|
1322
|
-
command: 'gsmVoice',
|
|
1323
|
-
description: 'Set GSM voice state (Emulator only).',
|
|
1324
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/gsm-voice/',
|
|
1325
|
-
parameters: [
|
|
1326
|
-
{
|
|
1327
|
-
name: 'state',
|
|
1328
|
-
type: 'string',
|
|
1329
|
-
description: "state of GSM voice - 'unregistered', 'home', 'roaming', 'searching', 'denied', 'off', 'on'",
|
|
1330
|
-
required: true,
|
|
1331
|
-
},
|
|
1332
|
-
],
|
|
1333
|
-
support: {
|
|
1334
|
-
android: {
|
|
1335
|
-
UiAutomator: '4.2+',
|
|
1336
|
-
},
|
|
1337
|
-
},
|
|
1338
|
-
},
|
|
1339
|
-
},
|
|
1340
|
-
'/session/:sessionId/appium/device/send_sms': {
|
|
1341
|
-
POST: {
|
|
1342
|
-
command: 'sendSms',
|
|
1343
|
-
description: 'Simulate an SMS message (Emulator only).',
|
|
1344
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/network/send-sms/',
|
|
1345
|
-
parameters: [
|
|
1346
|
-
{
|
|
1347
|
-
name: 'phoneNumber',
|
|
1348
|
-
type: 'string',
|
|
1349
|
-
description: 'the phone number to send the SMS too',
|
|
1350
|
-
required: true,
|
|
1351
|
-
},
|
|
1352
|
-
{
|
|
1353
|
-
name: 'message',
|
|
1354
|
-
type: 'string',
|
|
1355
|
-
description: 'the SMS message',
|
|
1356
|
-
required: true,
|
|
1357
|
-
},
|
|
1358
|
-
],
|
|
1359
|
-
support: {
|
|
1360
|
-
android: {
|
|
1361
|
-
UiAutomator: '4.2+',
|
|
1362
|
-
},
|
|
1363
|
-
},
|
|
1364
|
-
},
|
|
1365
|
-
},
|
|
1366
|
-
'/session/:sessionId/appium/device/finger_print': {
|
|
1367
|
-
POST: {
|
|
1368
|
-
command: 'fingerPrint',
|
|
1369
|
-
description: 'Authenticate users by using their finger print scans on supported emulators.',
|
|
1370
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/authentication/finger-print/',
|
|
1371
|
-
parameters: [
|
|
1372
|
-
{
|
|
1373
|
-
name: 'fingerprintId',
|
|
1374
|
-
type: 'number',
|
|
1375
|
-
description: 'finger prints stored in Android Keystore system (from 1 to 10)',
|
|
1376
|
-
required: true,
|
|
1377
|
-
},
|
|
1378
|
-
],
|
|
1379
|
-
support: {
|
|
1380
|
-
android: {
|
|
1381
|
-
UiAutomator: '4.2+',
|
|
1382
|
-
},
|
|
1383
|
-
},
|
|
1384
|
-
},
|
|
1385
|
-
},
|
|
1386
|
-
'/session/:sessionId/appium/device/set_clipboard': {
|
|
1387
|
-
POST: {
|
|
1388
|
-
command: 'setClipboard',
|
|
1389
|
-
description: 'Set the content of the system clipboard',
|
|
1390
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/clipboard/set-clipboard/',
|
|
1391
|
-
parameters: [
|
|
1392
|
-
{
|
|
1393
|
-
name: 'content',
|
|
1394
|
-
type: 'string',
|
|
1395
|
-
description: 'The actual base64 encoded clipboard content',
|
|
1396
|
-
required: true,
|
|
1397
|
-
},
|
|
1398
|
-
{
|
|
1399
|
-
name: 'contentType',
|
|
1400
|
-
type: 'string',
|
|
1401
|
-
description: 'The type of the content to get. Plaintext, Image, URL. Android supports only plaintext',
|
|
1402
|
-
required: false,
|
|
1403
|
-
},
|
|
1404
|
-
{
|
|
1405
|
-
name: 'label',
|
|
1406
|
-
type: 'string',
|
|
1407
|
-
description: 'Clipboard data label for Android',
|
|
1408
|
-
required: false,
|
|
1409
|
-
},
|
|
1410
|
-
],
|
|
1411
|
-
returns: {
|
|
1412
|
-
type: 'string',
|
|
1413
|
-
name: 'response',
|
|
1414
|
-
description: 'Response from Appium server',
|
|
1415
|
-
},
|
|
1416
|
-
support: {
|
|
1417
|
-
ios: {
|
|
1418
|
-
XCUITest: '9.3+',
|
|
1419
|
-
},
|
|
1420
|
-
android: {
|
|
1421
|
-
UiAutomator: '4.2+',
|
|
1422
|
-
},
|
|
1423
|
-
},
|
|
1424
|
-
},
|
|
1425
|
-
},
|
|
1426
|
-
'/session/:sessionId/appium/device/get_clipboard': {
|
|
1427
|
-
POST: {
|
|
1428
|
-
command: 'getClipboard',
|
|
1429
|
-
description: 'Get the content of the system clipboard',
|
|
1430
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/device/clipboard/get-clipboard/',
|
|
1431
|
-
parameters: [
|
|
1432
|
-
{
|
|
1433
|
-
name: 'contentType',
|
|
1434
|
-
type: 'string',
|
|
1435
|
-
description: 'The type of the content to get. Plaintext, Image, URL. Android supports only plaintext',
|
|
1436
|
-
required: false,
|
|
1437
|
-
},
|
|
1438
|
-
],
|
|
1439
|
-
returns: {
|
|
1440
|
-
type: 'string',
|
|
1441
|
-
name: 'response',
|
|
1442
|
-
description: 'Clipboard content as base64-encoded string or an empty string if the clipboard is empty',
|
|
1443
|
-
},
|
|
1444
|
-
support: {
|
|
1445
|
-
ios: {
|
|
1446
|
-
XCUITest: '9.3+',
|
|
1447
|
-
},
|
|
1448
|
-
android: {
|
|
1449
|
-
UiAutomator: '4.2+',
|
|
1450
|
-
},
|
|
1451
|
-
},
|
|
1452
|
-
},
|
|
1453
|
-
},
|
|
1454
|
-
'/session/:sessionId/touch/perform': {
|
|
1455
|
-
POST: {
|
|
1456
|
-
command: 'touchPerform',
|
|
1457
|
-
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.",
|
|
1458
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/interactions/touch/touch-perform/',
|
|
1459
|
-
parameters: [
|
|
1460
|
-
{
|
|
1461
|
-
name: 'actions',
|
|
1462
|
-
type: 'object[]',
|
|
1463
|
-
description: 'The type of action to perform (e.g. moveTo, release, press, tap, wait)',
|
|
1464
|
-
required: true,
|
|
1465
|
-
},
|
|
1466
|
-
],
|
|
1467
|
-
examples: [
|
|
1468
|
-
[
|
|
1469
|
-
'// do a horizontal swipe by percentage',
|
|
1470
|
-
'const startPercentage = 10;',
|
|
1471
|
-
'const endPercentage = 90;',
|
|
1472
|
-
'const anchorPercentage = 50;',
|
|
1473
|
-
'',
|
|
1474
|
-
'const { width, height } = driver.getWindowSize();',
|
|
1475
|
-
'const anchor = height * anchorPercentage / 100;',
|
|
1476
|
-
'const startPoint = width * startPercentage / 100;',
|
|
1477
|
-
'const endPoint = width * endPercentage / 100;',
|
|
1478
|
-
'driver.touchPerform([',
|
|
1479
|
-
' {',
|
|
1480
|
-
" action: 'press',",
|
|
1481
|
-
' options: {',
|
|
1482
|
-
' x: startPoint,',
|
|
1483
|
-
' y: anchor,',
|
|
1484
|
-
' },',
|
|
1485
|
-
' },',
|
|
1486
|
-
' {',
|
|
1487
|
-
" action: 'wait',",
|
|
1488
|
-
' options: {',
|
|
1489
|
-
' ms: 100,',
|
|
1490
|
-
' },',
|
|
1491
|
-
' },',
|
|
1492
|
-
' {',
|
|
1493
|
-
" action: 'moveTo',",
|
|
1494
|
-
' options: {',
|
|
1495
|
-
' x: endPoint,',
|
|
1496
|
-
' y: anchor,',
|
|
1497
|
-
' },',
|
|
1498
|
-
' },',
|
|
1499
|
-
' {',
|
|
1500
|
-
" action: 'release',",
|
|
1501
|
-
' options: {},',
|
|
1502
|
-
' },',
|
|
1503
|
-
']);',
|
|
1504
|
-
],
|
|
1505
|
-
],
|
|
1506
|
-
support: {
|
|
1507
|
-
android: {
|
|
1508
|
-
UiAutomator: '4.2+',
|
|
1509
|
-
},
|
|
1510
|
-
ios: {
|
|
1511
|
-
XCUITest: '9.3+',
|
|
1512
|
-
UIAutomation: '8.0 to 9.3',
|
|
1513
|
-
},
|
|
1514
|
-
windows: {
|
|
1515
|
-
Windows: '10+',
|
|
1516
|
-
},
|
|
1517
|
-
},
|
|
1518
|
-
},
|
|
1519
|
-
},
|
|
1520
|
-
'/session/:sessionId/touch/multi/perform': {
|
|
1521
|
-
POST: {
|
|
1522
|
-
command: 'multiTouchPerform',
|
|
1523
|
-
description: 'This functionality is only available from within a native context. Perform a multi touch action sequence.',
|
|
1524
|
-
ref: 'https://appium.github.io/appium.io/docs/en/commands/interactions/touch/multi-touch-perform/',
|
|
1525
|
-
parameters: [
|
|
1526
|
-
{
|
|
1527
|
-
name: 'actions',
|
|
1528
|
-
type: 'object[]',
|
|
1529
|
-
description: 'The type of action to perform (e.g. moveTo, release, press, tap, wait)',
|
|
1530
|
-
required: true,
|
|
1531
|
-
},
|
|
1532
|
-
],
|
|
1533
|
-
support: {
|
|
1534
|
-
android: {
|
|
1535
|
-
UiAutomator: '4.2+',
|
|
1536
|
-
},
|
|
1537
|
-
ios: {
|
|
1538
|
-
XCUITest: '9.3+',
|
|
1539
|
-
UIAutomation: '8.0 to 9.3',
|
|
1540
|
-
},
|
|
1541
|
-
windows: {
|
|
1542
|
-
Windows: '10+',
|
|
1543
|
-
},
|
|
1544
|
-
},
|
|
1545
|
-
},
|
|
1546
|
-
},
|
|
1547
|
-
'/session/:sessionId/appium/execute_driver': {
|
|
1548
|
-
POST: {
|
|
1549
|
-
command: 'executeDriverScript',
|
|
1550
|
-
description: 'This command enables you to specify a WebdriverIO script as a string and transmit it to the Appium server for local execution on the server itself. This approach helps minimize potential latency associated with each command. ***To utilize this command with Appium 2.0, you must have the [`execute-driver-plugin`](https://github.com/appium/appium/tree/master/packages/execute-driver-plugin) plugin installed.***',
|
|
1551
|
-
ref: 'https://github.com/appium/appium/blob/master/docs/en/commands/session/execute-driver.md',
|
|
1552
|
-
parameters: [
|
|
1553
|
-
{
|
|
1554
|
-
name: 'script',
|
|
1555
|
-
type: 'string',
|
|
1556
|
-
description: "The script to execute. It has access to a 'driver' object which represents a WebdriverIO session attached to the current server.",
|
|
1557
|
-
required: true,
|
|
1558
|
-
},
|
|
1559
|
-
{
|
|
1560
|
-
name: 'type',
|
|
1561
|
-
type: 'string',
|
|
1562
|
-
description: "The language/framework used in the script. Currently, only 'webdriverio' is supported and is the default.",
|
|
1563
|
-
required: false,
|
|
1564
|
-
},
|
|
1565
|
-
{
|
|
1566
|
-
name: 'timeout',
|
|
1567
|
-
type: 'number',
|
|
1568
|
-
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.',
|
|
1569
|
-
required: false,
|
|
1570
|
-
},
|
|
1571
|
-
],
|
|
1572
|
-
returns: {
|
|
1573
|
-
type: 'object',
|
|
1574
|
-
name: 'result',
|
|
1575
|
-
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.",
|
|
1576
|
-
},
|
|
1577
|
-
},
|
|
1578
|
-
},
|
|
1579
|
-
'/session/:sessionId/appium/events': {
|
|
1580
|
-
POST: {
|
|
1581
|
-
command: 'getEvents',
|
|
1582
|
-
description: 'Get events stored in appium server.',
|
|
1583
|
-
ref: 'https://github.com/appium/appium/blob/master/docs/en/commands/session/events/get-events.md',
|
|
1584
|
-
parameters: [
|
|
1585
|
-
{
|
|
1586
|
-
name: 'type',
|
|
1587
|
-
type: 'string[]',
|
|
1588
|
-
description: 'Get events which are filtered with the type if the type is provided.',
|
|
1589
|
-
required: true,
|
|
1590
|
-
},
|
|
1591
|
-
],
|
|
1592
|
-
returns: {
|
|
1593
|
-
type: 'object',
|
|
1594
|
-
name: 'result',
|
|
1595
|
-
description: "A JSON hash of events like `{'commands' => [{'cmd' => 123455, ....}], 'startTime' => 1572954894127, }`.",
|
|
1596
|
-
},
|
|
1597
|
-
support: {
|
|
1598
|
-
android: {
|
|
1599
|
-
UiAutomator: '4.2+',
|
|
1600
|
-
},
|
|
1601
|
-
ios: {
|
|
1602
|
-
XCUITest: '9.3+',
|
|
1603
|
-
},
|
|
1604
|
-
},
|
|
1605
|
-
},
|
|
1606
|
-
},
|
|
1607
|
-
'/session/:sessionId/appium/log_event': {
|
|
1608
|
-
POST: {
|
|
1609
|
-
command: 'logEvent',
|
|
1610
|
-
description: 'Store a custom event.',
|
|
1611
|
-
ref: 'https://github.com/appium/appium/blob/master/docs/en/commands/session/events/log-event.md',
|
|
1612
|
-
parameters: [
|
|
1613
|
-
{
|
|
1614
|
-
name: 'vendor',
|
|
1615
|
-
type: 'string',
|
|
1616
|
-
description: 'The name of vendor. It will be `vendor` in `vendor:event`.',
|
|
1617
|
-
required: true,
|
|
1618
|
-
},
|
|
1619
|
-
{
|
|
1620
|
-
name: 'event',
|
|
1621
|
-
type: 'string',
|
|
1622
|
-
description: 'The name of event. It will be `event` in `vendor:event`.',
|
|
1623
|
-
required: true,
|
|
1624
|
-
},
|
|
1625
|
-
],
|
|
1626
|
-
support: {
|
|
1627
|
-
android: {
|
|
1628
|
-
UiAutomator: '4.2+',
|
|
1629
|
-
},
|
|
1630
|
-
ios: {
|
|
1631
|
-
XCUITest: '9.3+',
|
|
1632
|
-
},
|
|
1633
|
-
},
|
|
1634
|
-
},
|
|
1635
|
-
},
|
|
1636
|
-
'/session/:sessionId/appium/compare_images': {
|
|
1637
|
-
POST: {
|
|
1638
|
-
command: 'compareImages',
|
|
1639
|
-
description: 'This feature conducts image comparisons utilizing the capabilities of the OpenCV framework. Please note that for this functionality to work, both the OpenCV framework and the opencv4nodejs module must be installed on the machine where the Appium server is operational. ***Furthermore, you\'ll need to have the [`images-plugin`](https://github.com/appium/appium/tree/master/packages/images-plugin) plugin installed to use this feature with Appium 2.0.***',
|
|
1640
|
-
ref: 'https://appium.github.io/appium.io/docs/en/writing-running-appium/image-comparison/',
|
|
1641
|
-
parameters: [
|
|
1642
|
-
{
|
|
1643
|
-
name: 'mode',
|
|
1644
|
-
type: 'string',
|
|
1645
|
-
description: "One of possible comparison modes: 'matchFeatures', 'getSimilarity', 'matchTemplate'. 'matchFeatures' is by default.",
|
|
1646
|
-
required: true,
|
|
1647
|
-
default: 'matchFeatures',
|
|
1648
|
-
},
|
|
1649
|
-
{
|
|
1650
|
-
name: 'firstImage',
|
|
1651
|
-
type: 'string',
|
|
1652
|
-
description: 'An image data. All image formats, that OpenCV library itself accepts, are supported.',
|
|
1653
|
-
required: true,
|
|
1654
|
-
},
|
|
1655
|
-
{
|
|
1656
|
-
name: 'secondImage',
|
|
1657
|
-
type: 'string',
|
|
1658
|
-
description: 'An image data. All image formats, that OpenCV library itself accepts, are supported.',
|
|
1659
|
-
required: true,
|
|
1660
|
-
},
|
|
1661
|
-
{
|
|
1662
|
-
name: 'options',
|
|
1663
|
-
type: 'object',
|
|
1664
|
-
description: 'The content of this dictionary depends on the actual `mode` value. See the documentation on `appium-support` module for more details. ',
|
|
1665
|
-
required: true,
|
|
1666
|
-
default: {},
|
|
1667
|
-
},
|
|
1668
|
-
],
|
|
1669
|
-
returns: {
|
|
1670
|
-
type: 'object',
|
|
1671
|
-
name: 'result',
|
|
1672
|
-
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.',
|
|
1673
|
-
},
|
|
1674
|
-
},
|
|
1675
|
-
},
|
|
1676
|
-
'/session/:sessionId/timeouts/implicit_wait': {
|
|
1677
|
-
POST: {
|
|
1678
|
-
command: 'implicitWait',
|
|
1679
|
-
description: 'Set the amount of time the driver should wait when searching for elements. When searching for a single element, the driver should poll the page until an element is found or the timeout expires, whichever occurs first. When searching for multiple elements, the driver should poll the page until at least one element is found or the timeout expires, at which point it should return an empty list. If this command is never sent, the driver should default to an implicit wait of 0ms.',
|
|
1680
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1681
|
-
parameters: [
|
|
1682
|
-
{
|
|
1683
|
-
name: 'ms',
|
|
1684
|
-
type: 'number',
|
|
1685
|
-
description: 'The amount of time, in milliseconds, to wait on an element.',
|
|
1686
|
-
required: true,
|
|
1687
|
-
},
|
|
1688
|
-
],
|
|
1689
|
-
support: {
|
|
1690
|
-
android: {
|
|
1691
|
-
UiAutomator: '4.2+',
|
|
1692
|
-
},
|
|
1693
|
-
ios: {
|
|
1694
|
-
XCUITest: '9.3+',
|
|
1695
|
-
},
|
|
1696
|
-
},
|
|
1697
|
-
},
|
|
1698
|
-
},
|
|
1699
|
-
'/session/:sessionId/element/:elementId/location_in_view': {
|
|
1700
|
-
GET: {
|
|
1701
|
-
command: 'getLocationInView',
|
|
1702
|
-
description: "Determine an element's location on the screen once it has been scrolled into view.<br /><br />__Note:__ This is considered an internal command and should only be used to determine an element's location for correctly generating native events.",
|
|
1703
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1704
|
-
variables: [
|
|
1705
|
-
{
|
|
1706
|
-
name: 'elementId',
|
|
1707
|
-
description: 'ID of the element to route the command to',
|
|
1708
|
-
},
|
|
1709
|
-
],
|
|
1710
|
-
parameters: [],
|
|
1711
|
-
returns: {
|
|
1712
|
-
type: 'Object',
|
|
1713
|
-
name: 'location',
|
|
1714
|
-
description: 'The X and Y coordinates for the element on the page.',
|
|
1715
|
-
},
|
|
1716
|
-
support: {
|
|
1717
|
-
android: {
|
|
1718
|
-
UiAutomator: '4.2+',
|
|
1719
|
-
},
|
|
1720
|
-
ios: {
|
|
1721
|
-
XCUITest: '9.3+',
|
|
1722
|
-
},
|
|
1723
|
-
},
|
|
1724
|
-
},
|
|
1725
|
-
},
|
|
1726
|
-
'/session/:sessionId/keys': {
|
|
1727
|
-
POST: {
|
|
1728
|
-
command: 'sendKeys',
|
|
1729
|
-
description: 'Send a sequence of key strokes to the active element',
|
|
1730
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1731
|
-
parameters: [
|
|
1732
|
-
{
|
|
1733
|
-
name: 'value',
|
|
1734
|
-
type: 'string[]',
|
|
1735
|
-
description: 'The sequence of keys to type. An array must be provided.',
|
|
1736
|
-
required: true,
|
|
1737
|
-
},
|
|
1738
|
-
],
|
|
1739
|
-
support: {
|
|
1740
|
-
android: {
|
|
1741
|
-
UiAutomator: '4.2+',
|
|
1742
|
-
},
|
|
1743
|
-
ios: {
|
|
1744
|
-
XCUITest: '9.3+',
|
|
1745
|
-
},
|
|
1746
|
-
},
|
|
1747
|
-
},
|
|
1748
|
-
},
|
|
1749
|
-
'/session/:sessionId/ime/available_engines': {
|
|
1750
|
-
GET: {
|
|
1751
|
-
command: 'availableIMEEngines',
|
|
1752
|
-
description: 'List all available engines on the machine. To use an engine, it has to be present in this list.',
|
|
1753
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1754
|
-
parameters: [],
|
|
1755
|
-
returns: {
|
|
1756
|
-
type: 'String[]',
|
|
1757
|
-
name: 'engines',
|
|
1758
|
-
description: 'A list of available engines',
|
|
1759
|
-
},
|
|
1760
|
-
support: {
|
|
1761
|
-
android: {
|
|
1762
|
-
UiAutomator: '4.2+',
|
|
1763
|
-
}
|
|
1764
|
-
},
|
|
1765
|
-
},
|
|
1766
|
-
},
|
|
1767
|
-
'/session/:sessionId/ime/active_engine': {
|
|
1768
|
-
GET: {
|
|
1769
|
-
command: 'getActiveIMEEngine',
|
|
1770
|
-
description: 'Get the name of the active IME engine. The name string is platform specific.',
|
|
1771
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1772
|
-
parameters: [],
|
|
1773
|
-
returns: {
|
|
1774
|
-
type: 'String',
|
|
1775
|
-
name: 'engine',
|
|
1776
|
-
description: 'The name of the active IME engine',
|
|
1777
|
-
},
|
|
1778
|
-
support: {
|
|
1779
|
-
android: {
|
|
1780
|
-
UiAutomator: '4.2+',
|
|
1781
|
-
}
|
|
1782
|
-
},
|
|
1783
|
-
},
|
|
1784
|
-
},
|
|
1785
|
-
'/session/:sessionId/ime/activated': {
|
|
1786
|
-
GET: {
|
|
1787
|
-
command: 'isIMEActivated',
|
|
1788
|
-
description: 'Indicates whether IME input is active at the moment',
|
|
1789
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1790
|
-
parameters: [],
|
|
1791
|
-
returns: {
|
|
1792
|
-
type: 'Boolean',
|
|
1793
|
-
name: 'isActive',
|
|
1794
|
-
description: 'true if IME input is available and currently active, false otherwise',
|
|
1795
|
-
},
|
|
1796
|
-
support: {
|
|
1797
|
-
android: {
|
|
1798
|
-
UiAutomator: '4.2+',
|
|
1799
|
-
}
|
|
1800
|
-
},
|
|
1801
|
-
},
|
|
1802
|
-
},
|
|
1803
|
-
'/session/:sessionId/ime/deactivate': {
|
|
1804
|
-
POST: {
|
|
1805
|
-
command: 'deactivateIMEEngine',
|
|
1806
|
-
description: 'De-activates the currently-active IME engine.',
|
|
1807
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1808
|
-
parameters: [],
|
|
1809
|
-
support: {
|
|
1810
|
-
android: {
|
|
1811
|
-
UiAutomator: '4.2+',
|
|
1812
|
-
}
|
|
1813
|
-
},
|
|
1814
|
-
},
|
|
1815
|
-
},
|
|
1816
|
-
'/session/:sessionId/ime/activate': {
|
|
1817
|
-
POST: {
|
|
1818
|
-
command: 'activateIMEEngine',
|
|
1819
|
-
description: 'Make an engines that is available',
|
|
1820
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1821
|
-
parameters: [
|
|
1822
|
-
{
|
|
1823
|
-
name: 'engine',
|
|
1824
|
-
type: 'string',
|
|
1825
|
-
description: 'name of the engine to activate',
|
|
1826
|
-
required: true,
|
|
1827
|
-
},
|
|
1828
|
-
],
|
|
1829
|
-
support: {
|
|
1830
|
-
android: {
|
|
1831
|
-
UiAutomator: '4.2+',
|
|
1832
|
-
}
|
|
1833
|
-
},
|
|
1834
|
-
},
|
|
1835
|
-
},
|
|
1836
|
-
'/session/:sessionId/timeouts/async_script': {
|
|
1837
|
-
POST: {
|
|
1838
|
-
command: 'asyncScriptTimeout',
|
|
1839
|
-
description: 'Set the amount of time, in milliseconds, that asynchronous scripts executed by `/session/:sessionId/execute_async` are permitted to run before they are aborted and a `Timeout` error is returned to the client.',
|
|
1840
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1841
|
-
parameters: [
|
|
1842
|
-
{
|
|
1843
|
-
name: 'ms',
|
|
1844
|
-
type: 'number',
|
|
1845
|
-
description: 'The amount of time, in milliseconds, that time-limited commands are permitted to run',
|
|
1846
|
-
required: true,
|
|
1847
|
-
},
|
|
1848
|
-
],
|
|
1849
|
-
support: {
|
|
1850
|
-
ios: {
|
|
1851
|
-
XCUITest: '9.3+',
|
|
1852
|
-
},
|
|
1853
|
-
},
|
|
1854
|
-
},
|
|
1855
|
-
},
|
|
1856
|
-
'/session/:sessionId/element/:elementId/submit': {
|
|
1857
|
-
POST: {
|
|
1858
|
-
command: 'submit',
|
|
1859
|
-
description: 'Submit a form element.',
|
|
1860
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1861
|
-
variables: [
|
|
1862
|
-
{
|
|
1863
|
-
name: 'elementId',
|
|
1864
|
-
description: 'ID of the form element to be submitted',
|
|
1865
|
-
},
|
|
1866
|
-
],
|
|
1867
|
-
parameters: [],
|
|
1868
|
-
support: {
|
|
1869
|
-
ios: {
|
|
1870
|
-
XCUITest: '9.3+',
|
|
1871
|
-
},
|
|
1872
|
-
},
|
|
1873
|
-
},
|
|
1874
|
-
},
|
|
1875
|
-
'/session/:sessionId/element/:elementId/size': {
|
|
1876
|
-
GET: {
|
|
1877
|
-
command: 'getElementSize',
|
|
1878
|
-
description: "Determine an element's size in pixels. The size will be returned as a JSON object with `width` and `height` properties.",
|
|
1879
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1880
|
-
variables: [
|
|
1881
|
-
{
|
|
1882
|
-
name: 'elementId',
|
|
1883
|
-
description: 'ID of the element to route the command to',
|
|
1884
|
-
},
|
|
1885
|
-
],
|
|
1886
|
-
parameters: [],
|
|
1887
|
-
returns: {
|
|
1888
|
-
type: 'Object',
|
|
1889
|
-
name: 'size',
|
|
1890
|
-
description: 'The width and height of the element, in pixels.',
|
|
1891
|
-
},
|
|
1892
|
-
support: {
|
|
1893
|
-
android: {
|
|
1894
|
-
UiAutomator: '4.2+',
|
|
1895
|
-
},
|
|
1896
|
-
ios: {
|
|
1897
|
-
XCUITest: '9.3+',
|
|
1898
|
-
},
|
|
1899
|
-
},
|
|
1900
|
-
},
|
|
1901
|
-
},
|
|
1902
|
-
'/session/:sessionId/element/:elementId/location': {
|
|
1903
|
-
GET: {
|
|
1904
|
-
command: 'getElementLocation',
|
|
1905
|
-
description: "Determine an element's location on the page. The point `(0, 0)` refers to the upper-left corner of the page. The element's coordinates are returned as a JSON object with `x` and `y` properties.",
|
|
1906
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1907
|
-
variables: [
|
|
1908
|
-
{
|
|
1909
|
-
name: 'elementId',
|
|
1910
|
-
description: 'ID of the element to route the command to',
|
|
1911
|
-
},
|
|
1912
|
-
],
|
|
1913
|
-
parameters: [],
|
|
1914
|
-
returns: {
|
|
1915
|
-
type: 'Object',
|
|
1916
|
-
name: 'location',
|
|
1917
|
-
description: 'The X and Y coordinates for the element on the page.',
|
|
1918
|
-
},
|
|
1919
|
-
support: {
|
|
1920
|
-
android: {
|
|
1921
|
-
UiAutomator: '4.2+',
|
|
1922
|
-
},
|
|
1923
|
-
ios: {
|
|
1924
|
-
XCUITest: '9.3+',
|
|
1925
|
-
},
|
|
1926
|
-
},
|
|
1927
|
-
},
|
|
1928
|
-
},
|
|
1929
|
-
'/session/:sessionId/touch/click': {
|
|
1930
|
-
POST: {
|
|
1931
|
-
command: 'touchClick',
|
|
1932
|
-
description: 'Single tap on the touch enabled device.',
|
|
1933
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1934
|
-
parameters: [
|
|
1935
|
-
{
|
|
1936
|
-
name: 'element',
|
|
1937
|
-
type: 'string',
|
|
1938
|
-
description: 'ID of the element to single tap on.',
|
|
1939
|
-
required: true,
|
|
1940
|
-
},
|
|
1941
|
-
],
|
|
1942
|
-
support: {
|
|
1943
|
-
android: {
|
|
1944
|
-
UiAutomator: '4.2+',
|
|
1945
|
-
},
|
|
1946
|
-
ios: {
|
|
1947
|
-
XCUITest: '9.3+',
|
|
1948
|
-
},
|
|
1949
|
-
},
|
|
1950
|
-
},
|
|
1951
|
-
},
|
|
1952
|
-
'/session/:sessionId/touch/down': {
|
|
1953
|
-
POST: {
|
|
1954
|
-
command: 'touchDown',
|
|
1955
|
-
description: 'Finger down on the screen.',
|
|
1956
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1957
|
-
parameters: [
|
|
1958
|
-
{
|
|
1959
|
-
name: 'x',
|
|
1960
|
-
type: 'number',
|
|
1961
|
-
description: 'x coordinate on the screen',
|
|
1962
|
-
required: true,
|
|
1963
|
-
},
|
|
1964
|
-
{
|
|
1965
|
-
name: 'y',
|
|
1966
|
-
type: 'number',
|
|
1967
|
-
description: 'y coordinate on the screen',
|
|
1968
|
-
required: true,
|
|
1969
|
-
},
|
|
1970
|
-
],
|
|
1971
|
-
support: {
|
|
1972
|
-
android: {
|
|
1973
|
-
UiAutomator: '4.2+',
|
|
1974
|
-
}
|
|
1975
|
-
},
|
|
1976
|
-
},
|
|
1977
|
-
},
|
|
1978
|
-
'/session/:sessionId/touch/up': {
|
|
1979
|
-
POST: {
|
|
1980
|
-
command: 'touchUp',
|
|
1981
|
-
description: 'Finger up on the screen.',
|
|
1982
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
1983
|
-
parameters: [
|
|
1984
|
-
{
|
|
1985
|
-
name: 'x',
|
|
1986
|
-
type: 'number',
|
|
1987
|
-
description: 'x coordinate on the screen',
|
|
1988
|
-
required: true,
|
|
1989
|
-
},
|
|
1990
|
-
{
|
|
1991
|
-
name: 'y',
|
|
1992
|
-
type: 'number',
|
|
1993
|
-
description: 'y coordinate on the screen',
|
|
1994
|
-
required: true,
|
|
1995
|
-
},
|
|
1996
|
-
],
|
|
1997
|
-
support: {
|
|
1998
|
-
android: {
|
|
1999
|
-
UiAutomator: '4.2+',
|
|
2000
|
-
}
|
|
2001
|
-
},
|
|
2002
|
-
},
|
|
2003
|
-
},
|
|
2004
|
-
'/session/:sessionId/touch/move': {
|
|
2005
|
-
POST: {
|
|
2006
|
-
command: 'touchMove',
|
|
2007
|
-
description: 'Finger move on the screen.',
|
|
2008
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2009
|
-
parameters: [
|
|
2010
|
-
{
|
|
2011
|
-
name: 'x',
|
|
2012
|
-
type: 'number',
|
|
2013
|
-
description: 'x coordinate on the screen',
|
|
2014
|
-
required: true,
|
|
2015
|
-
},
|
|
2016
|
-
{
|
|
2017
|
-
name: 'y',
|
|
2018
|
-
type: 'number',
|
|
2019
|
-
description: 'y coordinate on the screen',
|
|
2020
|
-
required: true,
|
|
2021
|
-
},
|
|
2022
|
-
],
|
|
2023
|
-
support: {
|
|
2024
|
-
android: {
|
|
2025
|
-
UiAutomator: '4.2+',
|
|
2026
|
-
}
|
|
2027
|
-
},
|
|
2028
|
-
},
|
|
2029
|
-
},
|
|
2030
|
-
'/session/:sessionId/touch/longclick': {
|
|
2031
|
-
POST: {
|
|
2032
|
-
command: 'touchLongClick',
|
|
2033
|
-
description: 'Long press on the touch screen using finger motion events.',
|
|
2034
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2035
|
-
parameters: [
|
|
2036
|
-
{
|
|
2037
|
-
name: 'element',
|
|
2038
|
-
type: 'string',
|
|
2039
|
-
description: 'ID of the element to long press on',
|
|
2040
|
-
required: true,
|
|
2041
|
-
},
|
|
2042
|
-
],
|
|
2043
|
-
support: {
|
|
2044
|
-
android: {
|
|
2045
|
-
UiAutomator: '4.2+',
|
|
2046
|
-
}
|
|
2047
|
-
},
|
|
2048
|
-
},
|
|
2049
|
-
},
|
|
2050
|
-
'/session/:sessionId/touch/flick': {
|
|
2051
|
-
POST: {
|
|
2052
|
-
command: 'touchFlick',
|
|
2053
|
-
description: 'Flick on the touch screen using finger motion events. This flick command starts at a particular screen location.',
|
|
2054
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2055
|
-
parameters: [
|
|
2056
|
-
{
|
|
2057
|
-
name: 'xoffset',
|
|
2058
|
-
type: 'number',
|
|
2059
|
-
description: 'the x offset in pixels to flick by',
|
|
2060
|
-
required: false,
|
|
2061
|
-
},
|
|
2062
|
-
{
|
|
2063
|
-
name: 'yoffset',
|
|
2064
|
-
type: 'number',
|
|
2065
|
-
description: 'the y offset in pixels to flick by',
|
|
2066
|
-
required: false,
|
|
2067
|
-
},
|
|
2068
|
-
{
|
|
2069
|
-
name: 'element',
|
|
2070
|
-
type: 'string',
|
|
2071
|
-
description: 'ID of the element where the flick starts',
|
|
2072
|
-
required: false,
|
|
2073
|
-
},
|
|
2074
|
-
{
|
|
2075
|
-
name: 'speed',
|
|
2076
|
-
type: 'number',
|
|
2077
|
-
description: 'the speed in pixels per seconds',
|
|
2078
|
-
required: false,
|
|
2079
|
-
},
|
|
2080
|
-
{
|
|
2081
|
-
name: 'xspeed',
|
|
2082
|
-
type: 'number',
|
|
2083
|
-
description: 'the x speed in pixels per second',
|
|
2084
|
-
required: false,
|
|
2085
|
-
},
|
|
2086
|
-
{
|
|
2087
|
-
name: 'yspeed',
|
|
2088
|
-
type: 'number',
|
|
2089
|
-
description: 'the y speed in pixels per second',
|
|
2090
|
-
required: false,
|
|
2091
|
-
},
|
|
2092
|
-
],
|
|
2093
|
-
support: {
|
|
2094
|
-
android: {
|
|
2095
|
-
UiAutomator: '4.2+',
|
|
2096
|
-
}
|
|
2097
|
-
},
|
|
2098
|
-
},
|
|
2099
|
-
},
|
|
2100
|
-
'/session/:sessionId/orientation': {
|
|
2101
|
-
GET: {
|
|
2102
|
-
command: 'getOrientation',
|
|
2103
|
-
description: 'Get the current device orientation.',
|
|
2104
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2105
|
-
parameters: [],
|
|
2106
|
-
returns: {
|
|
2107
|
-
type: 'String',
|
|
2108
|
-
name: 'orientation',
|
|
2109
|
-
description: 'The current orientation corresponding to a value defined in ScreenOrientation: `LANDSCAPE|PORTRAIT`.',
|
|
2110
|
-
},
|
|
2111
|
-
support: {
|
|
2112
|
-
android: {
|
|
2113
|
-
UiAutomator: '4.2+',
|
|
2114
|
-
},
|
|
2115
|
-
ios: {
|
|
2116
|
-
XCUITest: '9.3+',
|
|
2117
|
-
},
|
|
2118
|
-
},
|
|
2119
|
-
},
|
|
2120
|
-
POST: {
|
|
2121
|
-
command: 'setOrientation',
|
|
2122
|
-
description: 'Set the device orientation',
|
|
2123
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2124
|
-
parameters: [
|
|
2125
|
-
{
|
|
2126
|
-
name: 'orientation',
|
|
2127
|
-
type: 'string',
|
|
2128
|
-
description: 'the new browser orientation as defined in ScreenOrientation: `LANDSCAPE|PORTRAIT`',
|
|
2129
|
-
required: true,
|
|
2130
|
-
},
|
|
2131
|
-
],
|
|
2132
|
-
support: {
|
|
2133
|
-
android: {
|
|
2134
|
-
UiAutomator: '4.2+',
|
|
2135
|
-
},
|
|
2136
|
-
ios: {
|
|
2137
|
-
XCUITest: '9.3+',
|
|
2138
|
-
},
|
|
2139
|
-
},
|
|
2140
|
-
},
|
|
2141
|
-
},
|
|
2142
|
-
'/session/:sessionId/log': {
|
|
2143
|
-
POST: {
|
|
2144
|
-
command: 'getLogs',
|
|
2145
|
-
description: 'Get the log for a given log type. Log buffer is reset after each request.',
|
|
2146
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2147
|
-
parameters: [
|
|
2148
|
-
{
|
|
2149
|
-
name: 'type',
|
|
2150
|
-
type: 'string',
|
|
2151
|
-
description: 'the log type',
|
|
2152
|
-
required: true,
|
|
2153
|
-
},
|
|
2154
|
-
],
|
|
2155
|
-
returns: {
|
|
2156
|
-
type: 'Object[]',
|
|
2157
|
-
name: 'logs',
|
|
2158
|
-
description: 'The list of log entries.',
|
|
2159
|
-
},
|
|
2160
|
-
support: {
|
|
2161
|
-
android: {
|
|
2162
|
-
UiAutomator: '4.2+',
|
|
2163
|
-
},
|
|
2164
|
-
ios: {
|
|
2165
|
-
XCUITest: '9.3+',
|
|
2166
|
-
},
|
|
2167
|
-
},
|
|
2168
|
-
},
|
|
2169
|
-
},
|
|
2170
|
-
'/session/:sessionId/log/types': {
|
|
2171
|
-
GET: {
|
|
2172
|
-
command: 'getLogTypes',
|
|
2173
|
-
description: 'Get available log types.',
|
|
2174
|
-
ref: 'https://github.com/appium/appium/blob/master/packages/base-driver/docs/mjsonwp/protocol-methods.md#webdriver-endpoints',
|
|
2175
|
-
parameters: [],
|
|
2176
|
-
returns: {
|
|
2177
|
-
type: 'String[]',
|
|
2178
|
-
name: 'logTypes',
|
|
2179
|
-
description: 'The list of available log types.',
|
|
2180
|
-
},
|
|
2181
|
-
support: {
|
|
2182
|
-
android: {
|
|
2183
|
-
UiAutomator: '4.2+',
|
|
2184
|
-
},
|
|
2185
|
-
ios: {
|
|
2186
|
-
XCUITest: '9.3+',
|
|
2187
|
-
},
|
|
2188
|
-
},
|
|
2189
|
-
},
|
|
2190
|
-
},
|
|
2191
|
-
};
|