Class: FakeDriver<Thing>
@appium/fake-driver.FakeDriver
Implements
Type parameters
Name | Type |
---|---|
Thing |
any |
Hierarchy
-
FakeDriverAlertMixin
-
FakeDriverContextsMixin
-
FakeDriverElementsMixin
-
FakeDriverFindMixin
-
FakeDriverGeneralMixin
↳ FakeDriver
Table of contents
Constructors
Properties
- _eventHistory
- _log
- _proxyActive
- allowInsecure
- appModel
- basePath
- caps
- cliArgs
- commandsQueueGuard
- curContext
- denyInsecure
- desiredCapConstraints
- elMap
- eventEmitter
- fakeThing
- focusedElId
- helpers
- implicitWaitMs
- initialOpts
- locatorStrategies
- managedDrivers
- maxElId
- newCommandTimeoutMs
- noCommandTimer
- opts
- originalCaps
- protocol
- relaxedSecurityEnabled
- server
- serverHost
- serverPath
- serverPort
- sessionId
- settings
- shook
- shouldValidateCaps
- shutdownUnexpectedly
- supportedLogTypes
- webLocatorStrategies
- baseVersion
- executeMethodMap
- newMethodMap
Accessors
Methods
- addManagedDriver
- assertAlert
- assertFeatureEnabled
- assertNoAlert
- assertWebviewContext
- assignServer
- callDeprecatedCommand
- canProxy
- clear
- clearNewCommandTimeout
- click
- createSession
- deleteSession
- doubleClick
- driverForSession
- elementDisplayed
- elementEnabled
- elementSelected
- ensureFeatureEnabled
- equalsElement
- execute
- executeCommand
- executeMethod
- fakeAddition
- findElOrEls
- findElOrElsWithProcessing
- findElement
- findElementFromElement
- findElementFromShadowRoot
- findElements
- findElementsFromElement
- findElementsFromShadowRoot
- getAlertText
- getAttribute
- getContexts
- getCssProperty
- getCurrentContext
- getDeprecatedCommandsCalled
- getElement
- getElementRect
- getElements
- getExistingElementForNode
- getFakeDriverArgs
- getFakeThing
- getGeoLocation
- getLocation
- getLocationInView
- getLog
- getLogEvents
- getLogTypes
- getManagedDrivers
- getName
- getOrientation
- getPageSource
- getProxyAvoidList
- getRawContexts
- getScreenshot
- getSession
- getSessions
- getSettings
- getSize
- getStatus
- getText
- getTimeouts
- getWindowRect
- getWindowSize
- implicitWait
- implicitWaitForCondition
- implicitWaitMJSONWP
- implicitWaitW3C
- isFeatureEnabled
- isMjsonwpProtocol
- isW3CProtocol
- keys
- logCustomEvent
- logEvent
- logExtraCaps
- mobileShake
- newCommandTimeout
- onUnexpectedShutdown
- pageLoadTimeoutMJSONWP
- pageLoadTimeoutW3C
- parseTimeoutArgument
- performActions
- postAcceptAlert
- postDismissAlert
- proxyActive
- proxyCommand
- proxyReqRes
- proxyRouteIsAvoided
- releaseActions
- reset
- scriptTimeoutMJSONWP
- scriptTimeoutW3C
- sessionExists
- setAlertText
- setContext
- setFakeThing
- setFrame
- setGeoLocation
- setImplicitWait
- setNewCommandTimeout
- setOrientation
- setProtocolMJSONWP
- setProtocolW3C
- setValue
- startNewCommandTimeout
- startUnexpectedShutdown
- timeouts
- title
- updateSettings
- validateDesiredCaps
- validateLocatorStrategy
- wrapNewEl
- fakeRoute
- updateServer
Constructors
constructor
• new FakeDriver<Thing
>(opts?
, shouldValidateCaps?
)
Type parameters
Name | Type |
---|---|
Thing |
any |
Parameters
Name | Type | Default value |
---|---|---|
opts |
Object |
undefined |
opts.address |
string |
undefined |
opts.allowCors |
NonNullable <undefined | boolean > |
undefined |
opts.allowInsecure |
AllowInsecureConfig |
undefined |
opts.basePath |
string |
undefined |
opts.callbackAddress |
undefined | string |
undefined |
opts.callbackPort |
number |
undefined |
opts.debugLogSpacing |
NonNullable <undefined | boolean > |
undefined |
opts.defaultCapabilities |
undefined | DefaultCapabilitiesConfig |
undefined |
opts.denyInsecure |
DenyInsecureConfig |
undefined |
opts.driver |
undefined | DriverConfig |
undefined |
opts.fastReset? |
boolean |
undefined |
opts.keepAliveTimeout |
number |
undefined |
opts.localTimezone |
NonNullable <undefined | boolean > |
undefined |
opts.logFile |
undefined | string |
undefined |
opts.logFilters |
undefined | LogFiltersConfig |
undefined |
opts.logNoColors |
NonNullable <undefined | boolean > |
undefined |
opts.logTimestamp |
NonNullable <undefined | boolean > |
undefined |
opts.loglevel |
NonNullable <undefined | LogLevelConfig > |
undefined |
opts.longStacktrace |
NonNullable <undefined | boolean > |
undefined |
opts.noPermsCheck |
NonNullable <undefined | boolean > |
undefined |
opts.nodeconfig |
undefined | NodeconfigConfig |
undefined |
opts.plugin |
undefined | PluginConfig |
undefined |
opts.port |
number |
undefined |
opts.relaxedSecurityEnabled |
NonNullable <undefined | boolean > |
undefined |
opts.sessionOverride |
NonNullable <undefined | boolean > |
undefined |
opts.skipUninstall? |
boolean |
undefined |
opts.sslCertificatePath |
undefined | string |
undefined |
opts.sslKeyPath |
undefined | string |
undefined |
opts.strictCaps |
NonNullable <undefined | boolean > |
undefined |
opts.tmpDir |
undefined | string |
undefined |
opts.traceDir |
undefined | string |
undefined |
opts.useDrivers |
UseDriversConfig |
undefined |
opts.usePlugins |
UsePluginsConfig |
undefined |
opts.webhook |
undefined | string |
undefined |
shouldValidateCaps |
boolean |
true |
Overrides
Defined in
packages/fake-driver/lib/driver.js:56
Properties
_eventHistory
• Protected
_eventHistory: EventHistory
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:35
_log
• Protected
_log: AppiumLogger
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:40
_proxyActive
• _proxyActive: boolean
Defined in
packages/fake-driver/lib/driver.js:39
allowInsecure
• allowInsecure: string
[]
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:27
appModel
• appModel: FakeApp
Defined in
packages/fake-driver/lib/driver.js:36
basePath
• basePath: string
basePath is used for several purposes, for example in setting up proxying to other drivers, since we need to know what the base path of any incoming request might look like. We set it to the default initially but it is automatically updated during any actual program execution by the routeConfiguringFunction, which is necessarily run as the entrypoint for any Appium server
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:25
caps
• caps: DriverCaps
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }>
The processed capabilities used to start the session represented by the current driver instance
Inherited from
Defined in
packages/fake-driver/lib/driver.js:124
cliArgs
• cliArgs: StringRecord
& ServerArgs
The set of command line arguments set for this driver
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:4
commandsQueueGuard
• Protected
commandsQueueGuard: AsyncLock
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:43
curContext
• curContext: string
Defined in
packages/fake-driver/lib/driver.js:33
denyInsecure
• denyInsecure: string
[]
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:28
desiredCapConstraints
• Readonly
desiredCapConstraints: Object
Type declaration
Name | Type |
---|---|
app |
{ isString : true = true; presence : true = true } |
app.isString |
true |
app.presence |
true |
uniqueApp |
{ isBoolean : true = true } |
uniqueApp.isBoolean |
true |
Overrides
BaseDriver.desiredCapConstraints
Defined in
packages/fake-driver/lib/driver.js:30
elMap
• elMap: Record
<string
, FakeElement
>
Defined in
packages/fake-driver/lib/driver.js:54
eventEmitter
• eventEmitter: EventEmitter
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:36
fakeThing
• fakeThing: null
| Thing
Defined in
packages/fake-driver/lib/driver.js:48
focusedElId
• focusedElId: null
| string
Defined in
packages/fake-driver/lib/driver.js:45
helpers
• helpers: DriverHelpers
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:16
implicitWaitMs
• implicitWaitMs: number
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:30
initialOpts
• initialOpts: Object
Type declaration
Name | Type |
---|---|
address |
string |
allowCors |
NonNullable <undefined | boolean > |
allowInsecure |
AllowInsecureConfig |
basePath |
string |
callbackAddress |
undefined | string |
callbackPort |
number |
debugLogSpacing |
NonNullable <undefined | boolean > |
defaultCapabilities |
undefined | DefaultCapabilitiesConfig |
denyInsecure |
DenyInsecureConfig |
driver |
undefined | DriverConfig |
fastReset? |
boolean |
keepAliveTimeout |
number |
localTimezone |
NonNullable <undefined | boolean > |
logFile |
undefined | string |
logFilters |
undefined | LogFiltersConfig |
logNoColors |
NonNullable <undefined | boolean > |
logTimestamp |
NonNullable <undefined | boolean > |
loglevel |
NonNullable <undefined | LogLevelConfig > |
longStacktrace |
NonNullable <undefined | boolean > |
noPermsCheck |
NonNullable <undefined | boolean > |
nodeconfig |
undefined | NodeconfigConfig |
plugin |
undefined | PluginConfig |
port |
number |
relaxedSecurityEnabled |
NonNullable <undefined | boolean > |
sessionOverride |
NonNullable <undefined | boolean > |
skipUninstall? |
boolean |
sslCertificatePath |
undefined | string |
sslKeyPath |
undefined | string |
strictCaps |
NonNullable <undefined | boolean > |
tmpDir |
undefined | string |
traceDir |
undefined | string |
useDrivers |
UseDriversConfig |
usePlugins |
UsePluginsConfig |
webhook |
undefined | string |
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:15
locatorStrategies
• locatorStrategies: string
[]
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:31
managedDrivers
• managedDrivers: Driver
<Constraints
, StringRecord
, StringRecord
, DefaultCreateSessionResult
<Constraints
>, void
, StringRecord
>[]
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:33
maxElId
• maxElId: number
Defined in
packages/fake-driver/lib/driver.js:51
newCommandTimeoutMs
• newCommandTimeoutMs: number
Inherited from
BaseDriver.newCommandTimeoutMs
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:29
noCommandTimer
• noCommandTimer: null
| Timeout
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:34
opts
• opts: DriverOpts
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:14
originalCaps
• originalCaps: W3CDriverCaps
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }>
The original capabilities used to start the session represented by the current driver instance
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:6
protocol
• Optional
protocol: Protocol
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:51
relaxedSecurityEnabled
• relaxedSecurityEnabled: boolean
Inherited from
BaseDriver.relaxedSecurityEnabled
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:26
server
• Optional
server: AppiumServer
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:8
serverHost
• Optional
serverHost: string
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:9
serverPath
• Optional
serverPath: string
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:11
serverPort
• Optional
serverPort: number
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:10
sessionId
• sessionId: null
| string
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:13
settings
• settings: DeviceSettings
<StringRecord
>
settings should be instantiated by drivers which extend BaseDriver, but we set it to an empty DeviceSettings instance here to make sure that the default settings are applied even if an extending driver doesn't utilize the settings functionality itself
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:50
shook
• shook: boolean
Defined in
packages/fake-driver/lib/driver.js:42
shouldValidateCaps
• shouldValidateCaps: boolean
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:42
shutdownUnexpectedly
• shutdownUnexpectedly: boolean
Inherited from
BaseDriver.shutdownUnexpectedly
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:41
supportedLogTypes
• supportedLogTypes: Readonly
<LogDefRecord
>
Definition of the available log types
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:269
webLocatorStrategies
• webLocatorStrategies: string
[]
Inherited from
BaseDriver.webLocatorStrategies
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:32
baseVersion
▪ Static
baseVersion: string
Make the basedriver version available so for any driver which inherits from this package, we know which version of basedriver it inherited from
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:12
executeMethodMap
▪ Static
executeMethodMap: Object
Type declaration
Name | Type | Description |
---|---|---|
fake: addition |
{ command : "fakeAddition" = 'fakeAddition'; params : { optional : readonly ["num3" ] ; required : readonly ["num1" , "num2" ] } } |
- |
fake: addition.command |
"fakeAddition" |
- |
fake: addition.params |
{ optional : readonly ["num3" ] ; required : readonly ["num1" , "num2" ] } |
- |
fake: addition.params.optional |
readonly ["num3" ] |
- |
fake: addition.params.required |
readonly ["num1" , "num2" ] |
- |
fake: getDeprecatedCommandsCalled |
{ command : "getDeprecatedCommandsCalled" = 'getDeprecatedCommandsCalled' } |
- |
fake: getDeprecatedCommandsCalled.command |
"getDeprecatedCommandsCalled" |
- |
fake: getThing |
{ command : "getFakeThing" = 'getFakeThing' } |
Gets a thing (a fake thing) |
fake: getThing.command |
"getFakeThing" |
- |
fake: setThing |
{ command : "setFakeThing" = 'setFakeThing'; params : { required : readonly ["thing" ] } } |
- |
fake: setThing.command |
"setFakeThing" |
- |
fake: setThing.params |
{ required : readonly ["thing" ] } |
- |
fake: setThing.params.required |
readonly ["thing" ] |
- |
Defined in
packages/fake-driver/lib/driver.js:202
newMethodMap
▪ Static
newMethodMap: Object
Type declaration
Name | Type |
---|---|
/session/:sessionId/deprecated |
{ POST : { command : "callDeprecatedCommand" = 'callDeprecatedCommand'; deprecated : true = true } } |
/session/:sessionId/deprecated.POST |
{ command : "callDeprecatedCommand" = 'callDeprecatedCommand'; deprecated : true = true } |
/session/:sessionId/deprecated.POST.command |
"callDeprecatedCommand" |
/session/:sessionId/deprecated.POST.deprecated |
true |
/session/:sessionId/doubleclick |
{ POST : { command : "doubleClick" = 'doubleClick' } } |
/session/:sessionId/doubleclick.POST |
{ command : "doubleClick" = 'doubleClick' } |
/session/:sessionId/doubleclick.POST.command |
"doubleClick" |
/session/:sessionId/fakedriver |
{ GET : { command : "getFakeThing" = 'getFakeThing' } ; POST : { command : "setFakeThing" = 'setFakeThing'; payloadParams : { required : readonly ["thing" ] } } } |
/session/:sessionId/fakedriver.GET |
{ command : "getFakeThing" = 'getFakeThing' } |
/session/:sessionId/fakedriver.GET.command |
"getFakeThing" |
/session/:sessionId/fakedriver.POST |
{ command : "setFakeThing" = 'setFakeThing'; payloadParams : { required : readonly ["thing" ] } } |
/session/:sessionId/fakedriver.POST.command |
"setFakeThing" |
/session/:sessionId/fakedriver.POST.payloadParams |
{ required : readonly ["thing" ] } |
/session/:sessionId/fakedriver.POST.payloadParams.required |
readonly ["thing" ] |
/session/:sessionId/fakedriverargs |
{ GET : { command : "getFakeDriverArgs" = 'getFakeDriverArgs' } } |
/session/:sessionId/fakedriverargs.GET |
{ command : "getFakeDriverArgs" = 'getFakeDriverArgs' } |
/session/:sessionId/fakedriverargs.GET.command |
"getFakeDriverArgs" |
Defined in
packages/fake-driver/lib/driver.js:182
Accessors
_desiredCapConstraints
• Protected
get
_desiredCapConstraints(): Readonly
<{ app
: { isString
: true
} ; autoLaunch
: { isBoolean
: true
} ; autoWebview
: { isBoolean
: true
} ; automationName
: { isString
: true
} ; eventTimings
: { isBoolean
: true
} ; fullReset
: { isBoolean
: true
} ; language
: { isString
: true
} ; locale
: { isString
: true
} ; newCommandTimeout
: { isNumber
: true
} ; noReset
: { isBoolean
: true
} ; orientation
: { inclusion
: readonly ["LANDSCAPE"
, "PORTRAIT"
] } ; platformName
: { isString
: true
; presence
: true
} ; platformVersion
: { isString
: true
} ; printPageSourceOnFindFailure
: { isBoolean
: true
} ; udid
: { isString
: true
} ; webSocketUrl
: { isBoolean
: true
} } & C
>
Contains the base constraints plus whatever the subclass wants to add.
Subclasses shouldn't need to use this. If you need to use this, please create an issue:
See
https://github.com/appium/appium/issues/new
Returns
Readonly
<{ app
: { isString
: true
} ; autoLaunch
: { isBoolean
: true
} ; autoWebview
: { isBoolean
: true
} ; automationName
: { isString
: true
} ; eventTimings
: { isBoolean
: true
} ; fullReset
: { isBoolean
: true
} ; language
: { isString
: true
} ; locale
: { isString
: true
} ; newCommandTimeout
: { isNumber
: true
} ; noReset
: { isBoolean
: true
} ; orientation
: { inclusion
: readonly ["LANDSCAPE"
, "PORTRAIT"
] } ; platformName
: { isString
: true
; presence
: true
} ; platformVersion
: { isString
: true
} ; printPageSourceOnFindFailure
: { isBoolean
: true
} ; udid
: { isString
: true
} ; webSocketUrl
: { isBoolean
: true
} } & C
>
Inherited from
BaseDriver._desiredCapConstraints
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:20
driverData
• get
driverData(): Object
This property is used by AppiumDriver to store the data of the specific driver sessions. This data can be later used to adjust properties for driver instances running in parallel. Override it in inherited driver classes if necessary.
Returns
Object
Name | Type |
---|---|
isUnique |
boolean |
Overrides
BaseDriver.driverData
Defined in
packages/fake-driver/lib/driver.js:129
eventHistory
• get
eventHistory(): EventHistory
Returns
Inherited from
BaseDriver.eventHistory
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:83
isCommandsQueueEnabled
• get
isCommandsQueueEnabled(): boolean
This property controls the way the executeCommand
method
handles new driver commands received from the client.
Override it for inherited classes only in special cases.
Returns
boolean
If the returned value is true (default) then all the commands received by the particular driver instance are going to be put into the queue, so each following command will not be executed until the previous command execution is completed. False value disables that queue, so each driver command is executed independently and does not wait for anything.
Inherited from
BaseDriver.isCommandsQueueEnabled
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:82
log
• get
log(): AppiumLogger
Returns
Inherited from
BaseDriver.log
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:53
Methods
addManagedDriver
▸ addManagedDriver(driver
): void
Parameters
Name | Type |
---|---|
driver |
Driver <Constraints , StringRecord , StringRecord , DefaultCreateSessionResult <Constraints >, void , StringRecord > |
Returns
void
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:150
assertAlert
▸ assertAlert(): void
Returns
void
Defined in
packages/fake-driver/lib/commands/alert.ts:7
assertFeatureEnabled
▸ assertFeatureEnabled(name
): void
Assert that a given feature is enabled and throw a helpful error if it's not
Parameters
Name | Type | Description |
---|---|---|
name |
string |
name of feature/command |
Returns
void
Inherited from
BaseDriver.assertFeatureEnabled
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:127
assertNoAlert
▸ assertNoAlert(): void
Returns
void
Defined in
packages/fake-driver/lib/commands/alert.ts:6
assertWebviewContext
▸ assertWebviewContext(): void
Returns
void
Defined in
packages/fake-driver/lib/commands/contexts.ts:7
assignServer
▸ assignServer(server
, host
, port
, path
): void
A helper function used to assign server information to the driver instance so the driver knows where the server is Running
Parameters
Name | Type | Description |
---|---|---|
server |
AppiumServer |
the server object |
host |
string |
the server hostname |
port |
number |
the server port |
path |
string |
the server base url |
Returns
void
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:30
callDeprecatedCommand
▸ callDeprecatedCommand(): Promise
<void
>
This is a command that exists just to be an example of a deprecated command
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/driver.js:178
canProxy
▸ canProxy(): boolean
Returns
boolean
Overrides
Defined in
packages/fake-driver/lib/driver.js:76
clear
▸ clear(elementId
): Promise
<void
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/element.ts:17
clearNewCommandTimeout
▸ clearNewCommandTimeout(): Promise
<void
>
Returns
Promise
<void
>
Inherited from
BaseDriver.clearNewCommandTimeout
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:152
click
▸ click(elementId
): Promise
<void
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/element.ts:18
createSession
▸ createSession(w3cCapabilities1
, w3cCapabilities2?
, w3cCapabilities3?
, driverData?
): Promise
<[string
, FakeDriverCaps
]>
Comment for createSession
in FakeDriver
Parameters
Name | Type | Default value | Description |
---|---|---|---|
w3cCapabilities1 |
W3CFakeDriverCaps |
undefined |
W3C Capabilities |
w3cCapabilities2? |
W3CFakeDriverCaps |
undefined |
W3C Capabilities |
w3cCapabilities3? |
W3CFakeDriverCaps |
undefined |
W3C Capabilities |
driverData? |
DriverData [] |
[] |
Other session data |
Returns
Promise
<[string
, FakeDriverCaps
]>
Overrides
Defined in
packages/fake-driver/lib/driver.js:106
deleteSession
▸ deleteSession(sessionId?
): Promise
<void
>
Stop an automation session
See
https://w3c.github.io/webdriver/#delete-session
Parameters
Name | Type | Description |
---|---|---|
sessionId? |
null | string |
the id of the session that is to be deleted |
Returns
Promise
<void
>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:45
doubleClick
▸ doubleClick(): Promise
<void
>
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/general.ts:22
driverForSession
▸ driverForSession(sessionId
): null
| Core
<Constraints
, StringRecord
>
method required by MJSONWP in order to determine if the command should be proxied directly to the driver
Parameters
Name | Type |
---|---|
sessionId |
string |
Returns
null
| Core
<Constraints
, StringRecord
>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:102
elementDisplayed
▸ elementDisplayed(elementId
): Promise
<boolean
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<boolean
>
Defined in
packages/fake-driver/lib/commands/element.ts:12
elementEnabled
▸ elementEnabled(elementId
): Promise
<boolean
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<boolean
>
Defined in
packages/fake-driver/lib/commands/element.ts:13
elementSelected
▸ elementSelected(elementId
): Promise
<boolean
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<boolean
>
Defined in
packages/fake-driver/lib/commands/element.ts:14
ensureFeatureEnabled
▸ ensureFeatureEnabled(name
): void
Assert that a given feature is enabled and throw a helpful error if it's not
Deprecated
Parameters
Name | Type | Description |
---|---|---|
name |
string |
name of feature/command |
Returns
void
Inherited from
BaseDriver.ensureFeatureEnabled
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:120
equalsElement
▸ equalsElement(elementId
, otherElementId
): Promise
<boolean
>
Parameters
Name | Type |
---|---|
elementId |
string |
otherElementId |
string |
Returns
Promise
<boolean
>
Defined in
packages/fake-driver/lib/commands/element.ts:23
execute
▸ execute(script
, args
): Promise
<any
>
Parameters
Name | Type |
---|---|
script |
string |
args |
any [] |
Returns
Promise
<any
>
Defined in
packages/fake-driver/lib/commands/general.ts:23
executeCommand
▸ executeCommand<T
>(cmd
, ...args
): Promise
<T
>
This is the main command handler for the driver. It wraps command execution with timeout logic, checking that we have a valid session, and ensuring that we execute commands one at a time. This method is called by MJSONWP's express router.
Type parameters
Name | Type |
---|---|
T |
unknown |
Parameters
Name | Type |
---|---|
cmd |
string |
...args |
any [] |
Returns
Promise
<T
>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:27
executeMethod
▸ executeMethod<TArgs
, TReturn
>(script
, args
): Promise
<TReturn
>
Call an Execute Method
by its name with the given arguments. This method will check that the
driver has registered the method matching the name, and send it the arguments.
Type parameters
Name | Type |
---|---|
TArgs |
extends readonly any [] | readonly [StringRecord <unknown >] = unknown [] |
TReturn |
unknown |
Parameters
Name | Type | Description |
---|---|---|
script |
string |
the name of the Execute Method |
args |
TArgs |
a singleton array containing an arguments object |
Returns
Promise
<TReturn
>
The result of calling the Execute Method
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:148
fakeAddition
▸ fakeAddition(a
, b
, c?
): Promise
<number
>
Parameters
Name | Type |
---|---|
a |
number |
b |
number |
c? |
number |
Returns
Promise
<number
>
Defined in
packages/fake-driver/lib/commands/general.ts:24
findElOrEls
▸ findElOrEls(strategy
, selector
, mult
, context?
): Promise
<Element
<string
>[]>
A helper method that returns one or more UI elements based on the search criteria
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector |
mult |
true |
whether or not we want to find multiple elements |
context? |
any |
the element to use as the search context basis if desiredCapabilities |
Returns
Promise
<Element
<string
>[]>
A single element or list of elements
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:242
▸ findElOrEls(strategy
, selector
, mult
, context?
): Promise
<Element
<string
>>
Parameters
Name | Type |
---|---|
strategy |
string |
selector |
string |
mult |
false |
context? |
any |
Returns
Promise
<Element
<string
>>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:243
findElOrElsWithProcessing
▸ findElOrElsWithProcessing(strategy
, selector
, mult
, context?
): Promise
<Element
<string
>[]>
This is a wrapper for findElOrEls
that validates locator strategies
and implements the appium:printPageSourceOnFindFailure
capability
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector |
mult |
true |
whether or not we want to find multiple elements |
context? |
any |
the element to use as the search context basis if desiredCapabilities |
Returns
Promise
<Element
<string
>[]>
A single element or list of elements
Inherited from
BaseDriver.findElOrElsWithProcessing
Defined in
packages/types/build/lib/driver.d.ts:255
▸ findElOrElsWithProcessing(strategy
, selector
, mult
, context?
): Promise
<Element
<string
>>
Parameters
Name | Type |
---|---|
strategy |
string |
selector |
string |
mult |
false |
context? |
any |
Returns
Promise
<Element
<string
>>
Inherited from
BaseDriver.findElOrElsWithProcessing
Defined in
packages/types/build/lib/driver.d.ts:256
findElement
▸ findElement(strategy
, selector
): Promise
<Element
<string
>>
Find a UI element given a locator strategy and a selector, erroring if it can't be found
See
https://w3c.github.io/webdriver/#find-element
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector to combine with the strategy to find the specific element |
Returns
Promise
<Element
<string
>>
The element object encoding the element id which can be used in element-related commands
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:176
findElementFromElement
▸ findElementFromElement(strategy
, selector
, elementId
): Promise
<Element
<string
>>
Find a UI element given a locator strategy and a selector, erroring if it can't be found. Only look for elements among the set of descendants of a given element
See
https://w3c.github.io/webdriver/#find-element-from-element
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector to combine with the strategy to find the specific element |
elementId |
string |
the id of the element to use as the search basis |
Returns
Promise
<Element
<string
>>
The element object encoding the element id which can be used in element-related commands
Inherited from
BaseDriver.findElementFromElement
Defined in
packages/types/build/lib/driver.d.ts:199
findElementFromShadowRoot
▸ Optional
findElementFromShadowRoot(strategy
, selector
, shadowId
): Promise
<Element
<string
>>
Find an element from a shadow root
See
https://w3c.github.io/webdriver/#find-element-from-shadow-root
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector to combine with the strategy to find the specific elements |
shadowId |
string |
the id of the element to use as the search basis |
Returns
Promise
<Element
<string
>>
The element inside the shadow root matching the selector
Inherited from
BaseDriver.findElementFromShadowRoot
Defined in
packages/types/build/lib/driver.d.ts:221
findElements
▸ findElements(strategy
, selector
): Promise
<Element
<string
>[]>
Find a a list of all UI elements matching a given a locator strategy and a selector
See
https://w3c.github.io/webdriver/#find-elements
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector to combine with the strategy to find the specific elements |
Returns
Promise
<Element
<string
>[]>
A possibly-empty list of element objects
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:186
findElementsFromElement
▸ findElementsFromElement(strategy
, selector
, elementId
): Promise
<Element
<string
>[]>
Find a a list of all UI elements matching a given a locator strategy and a selector. Only look for elements among the set of descendants of a given element
See
https://w3c.github.io/webdriver/#find-elements-from-element
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector to combine with the strategy to find the specific elements |
elementId |
string |
the id of the element to use as the search basis |
Returns
Promise
<Element
<string
>[]>
A possibly-empty list of element objects
Inherited from
BaseDriver.findElementsFromElement
Defined in
packages/types/build/lib/driver.d.ts:211
findElementsFromShadowRoot
▸ Optional
findElementsFromShadowRoot(strategy
, selector
, shadowId
): Promise
<Element
<string
>[]>
Find elements from a shadow root
See
https://w3c.github.io/webdriver/#find-element-from-shadow-root
Parameters
Name | Type | Description |
---|---|---|
strategy |
string |
the locator strategy |
selector |
string |
the selector to combine with the strategy to find the specific elements |
shadowId |
string |
the id of the element to use as the search basis |
Returns
Promise
<Element
<string
>[]>
A possibly empty list of elements inside the shadow root matching the selector
Inherited from
BaseDriver.findElementsFromShadowRoot
Defined in
packages/types/build/lib/driver.d.ts:231
getAlertText
▸ getAlertText(): Promise
<string
>
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/alert.ts:9
getAttribute
▸ getAttribute(elementId
, attributeName
): Promise
<string
>
Parameters
Name | Type |
---|---|
elementId |
string |
attributeName |
string |
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/element.ts:20
getContexts
▸ getContexts(): Promise
<string
[]>
Returns
Promise
<string
[]>
Defined in
packages/fake-driver/lib/commands/contexts.ts:9
getCssProperty
▸ getCssProperty(elementId
, propertyName
): Promise
<string
>
Parameters
Name | Type |
---|---|
elementId |
string |
propertyName |
string |
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/element.ts:24
getCurrentContext
▸ getCurrentContext(): Promise
<string
>
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/contexts.ts:8
getDeprecatedCommandsCalled
▸ getDeprecatedCommandsCalled(): Promise
<string
[]>
This is a command that will return a list of deprecated command names called
Returns
Promise
<string
[]>
Defined in
packages/fake-driver/lib/driver.js:167
getElement
▸ getElement(elementId
): FakeElement
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
FakeElement
Defined in
packages/fake-driver/lib/commands/element.ts:10
getElementRect
▸ getElementRect(elementId
): Promise
<Rect
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<Rect
>
Defined in
packages/fake-driver/lib/commands/element.ts:21
getElements
▸ getElements(elementIds
): FakeElement
[]
Parameters
Name | Type |
---|---|
elementIds |
string [] |
Returns
FakeElement
[]
Defined in
packages/fake-driver/lib/commands/element.ts:9
getExistingElementForNode
▸ getExistingElementForNode(node
): null
| string
Parameters
Name | Type |
---|---|
node |
FakeElement |
Returns
null
| string
Defined in
packages/fake-driver/lib/commands/find.ts:69
getFakeDriverArgs
▸ getFakeDriverArgs(): Promise
<StringRecord
& ServerArgs
>
Get the driver args that were sent in via the CLI
Returns
Promise
<StringRecord
& ServerArgs
>
Defined in
packages/fake-driver/lib/driver.js:157
getFakeThing
▸ getFakeThing(): Promise
<null
| Thing
>
Returns
Promise
<null
| Thing
>
Defined in
packages/fake-driver/lib/driver.js:135
getGeoLocation
▸ getGeoLocation(): Promise
<Location
>
Returns
Promise
<Location
>
Defined in
packages/fake-driver/lib/commands/general.ts:12
getLocation
▸ getLocation(elementId
): Promise
<Position
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<Position
>
Defined in
packages/fake-driver/lib/commands/element.ts:25
getLocationInView
▸ getLocationInView(elementId
): Promise
<Position
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<Position
>
Defined in
packages/fake-driver/lib/commands/element.ts:26
getLog
▸ getLog(logType
): Promise
<any
>
Get the log for a given log type.
Parameters
Name | Type | Description |
---|---|---|
logType |
string |
Name/key of log type as defined in ILogCommands.supportedLogTypes. |
Returns
Promise
<any
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:279
getLogEvents
▸ getLogEvents(type?
): Promise
<EventHistory
| Record
<string
, number
>>
Get a list of events that have occurred in the current session
Parameters
Name | Type | Description |
---|---|---|
type? |
string | string [] |
filter the returned events by including one or more types |
Returns
Promise
<EventHistory
| Record
<string
, number
>>
The event history for the session
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:136
getLogTypes
▸ getLogTypes(): Promise
<string
[]>
Get available log types as a list of strings
Returns
Promise
<string
[]>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:273
getManagedDrivers
▸ getManagedDrivers(): Driver
<Constraints
, StringRecord
, StringRecord
, DefaultCreateSessionResult
<Constraints
>, void
, StringRecord
>[]
Returns
Driver
<Constraints
, StringRecord
, StringRecord
, DefaultCreateSessionResult
<Constraints
>, void
, StringRecord
>[]
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:151
getName
▸ getName(elementId
): Promise
<string
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/element.ts:11
getOrientation
▸ getOrientation(): Promise
<string
>
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/general.ts:14
getPageSource
▸ getPageSource(): Promise
<string
>
Get the current page/app source as HTML/XML
See
https://w3c.github.io/webdriver/#get-page-source
Returns
Promise
<string
>
The UI hierarchy in a platform-appropriate format (e.g., HTML for a web page)
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:263
getProxyAvoidList
▸ getProxyAvoidList(sessionId
): RouteMatcher
[]
Parameters
Name | Type |
---|---|
sessionId |
string |
Returns
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:130
getRawContexts
▸ getRawContexts(): Record
<string
, any
>
Returns
Record
<string
, any
>
Defined in
packages/fake-driver/lib/commands/contexts.ts:6
getScreenshot
▸ getScreenshot(): Promise
<string
>
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/general.ts:16
getSession
▸ getSession(): Promise
<SingularSessionData
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }, StringRecord
>>
Returns capabilities for the session and event history (if applicable)
Returns
Promise
<SingularSessionData
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }, StringRecord
>>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:44
getSessions
▸ getSessions(): Promise
<MultiSessionData
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }>[]>
Get data for all sessions running on an Appium server
Returns
Promise
<MultiSessionData
<{ app
: { isString
: true
= true; presence
: true
= true } ; uniqueApp
: { isBoolean
: true
= true } }>[]>
A list of session data objects
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:40
getSettings
▸ getSettings(): Promise
<StringRecord
>
Get the current settings for the session
Returns
Promise
<StringRecord
>
The settings object
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:49
getSize
▸ getSize(elementId
): Promise
<Size
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<Size
>
Defined in
packages/fake-driver/lib/commands/element.ts:22
getStatus
▸ getStatus(): Promise
<{}>
Returns
Promise
<{}>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:92
getText
▸ getText(elementId
): Promise
<string
>
Parameters
Name | Type |
---|---|
elementId |
string |
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/element.ts:16
getTimeouts
▸ getTimeouts(): Promise
<Record
<string
, number
>>
Get the current timeouts
See
https://w3c.github.io/webdriver/#get-timeouts
Returns
Promise
<Record
<string
, number
>>
A map of timeout names to ms values
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:66
getWindowRect
▸ getWindowRect(): Promise
<Rect
>
Returns
Promise
<Rect
>
Defined in
packages/fake-driver/lib/commands/general.ts:18
getWindowSize
▸ getWindowSize(): Promise
<Size
>
Returns
Promise
<Size
>
Defined in
packages/fake-driver/lib/commands/general.ts:17
implicitWait
▸ implicitWait(ms
): Promise
<void
>
Set the implicit wait timeout
Deprecated
Use timeouts
instead
Parameters
Name | Type | Description |
---|---|---|
ms |
string | number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:45
implicitWaitForCondition
▸ implicitWaitForCondition(condition
): Promise
<unknown
>
Periodically retry an async function up until the currently set implicit wait timeout
Parameters
Name | Type | Description |
---|---|---|
condition |
(...args : any []) => Promise <any > |
the behaviour to retry until it returns truthy |
Returns
Promise
<unknown
>
The return value of the condition
Inherited from
BaseDriver.implicitWaitForCondition
Defined in
packages/types/build/lib/driver.d.ts:59
implicitWaitMJSONWP
▸ implicitWaitMJSONWP(ms
): Promise
<void
>
Set the implicit wait value that was sent in via the JSONWP
Deprecated
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
BaseDriver.implicitWaitMJSONWP
Defined in
packages/types/build/lib/driver.d.ts:79
implicitWaitW3C
▸ implicitWaitW3C(ms
): Promise
<void
>
Set the implicit wait value that was sent in via the W3C protocol
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:72
isFeatureEnabled
▸ isFeatureEnabled(name
): boolean
Check whether a given feature is enabled via its name
Parameters
Name | Type | Description |
---|---|---|
name |
string |
name of feature/command |
Returns
boolean
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:112
isMjsonwpProtocol
▸ isMjsonwpProtocol(): boolean
Returns
boolean
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:103
isW3CProtocol
▸ isW3CProtocol(): boolean
Returns
boolean
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:104
keys
▸ keys(value
): Promise
<void
>
Parameters
Name | Type |
---|---|
value |
string | string [] |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/general.ts:10
logCustomEvent
▸ logCustomEvent(vendor
, event
): Promise
<void
>
Add a custom-named event to the Appium event log
Parameters
Name | Type | Description |
---|---|---|
vendor |
string |
the name of the vendor or tool the event belongs to, to namespace the event |
event |
string |
the name of the event itself |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:128
logEvent
▸ logEvent(eventName
): void
API method for driver developers to log timings for important events
Parameters
Name | Type |
---|---|
eventName |
string |
Returns
void
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:87
logExtraCaps
▸ logExtraCaps(caps
): void
A helper function to log unrecognized capabilities to the console
Params
caps - the capabilities
Parameters
Name | Type |
---|---|
caps |
ConstraintsToCaps <{ app : { isString : true = true; presence : true = true } ; uniqueApp : { isBoolean : true = true } }> |
Returns
void
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:46
mobileShake
▸ mobileShake(): Promise
<void
>
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/general.ts:21
newCommandTimeout
▸ newCommandTimeout(ms
): Promise
<void
>
Set Appium's new command timeout
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:111
onUnexpectedShutdown
▸ onUnexpectedShutdown(handler
): void
Set a callback handler if needed to execute a custom piece of code when the driver is shut down unexpectedly. Multiple calls to this method will cause the handler to be executed mutiple times
Parameters
Name | Type | Description |
---|---|---|
handler |
(...args : any []) => void |
The code to be executed on unexpected shutdown. The function may accept one argument, which is the actual error instance, which caused the driver to shut down. |
Returns
void
Inherited from
BaseDriver.onUnexpectedShutdown
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:63
pageLoadTimeoutMJSONWP
▸ pageLoadTimeoutMJSONWP(ms
): Promise
<void
>
Set the page load timeout value that was sent in via the JSONWP
Deprecated
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
BaseDriver.pageLoadTimeoutMJSONWP
Defined in
packages/types/build/lib/driver.d.ts:92
pageLoadTimeoutW3C
▸ pageLoadTimeoutW3C(ms
): Promise
<void
>
Set the page load timeout value that was sent in via the W3C protocol
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:85
parseTimeoutArgument
▸ parseTimeoutArgument(ms
): number
Get a timeout value from a number or a string
Parameters
Name | Type | Description |
---|---|---|
ms |
string | number |
the timeout value as a number or a string |
Returns
number
The timeout as a number in ms
Inherited from
BaseDriver.parseTimeoutArgument
Defined in
packages/types/build/lib/driver.d.ts:119
performActions
▸ performActions(actions
): Promise
<void
>
Parameters
Name | Type |
---|---|
actions |
ActionSequence [] |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/general.ts:19
postAcceptAlert
▸ postAcceptAlert(): Promise
<void
>
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/alert.ts:13
postDismissAlert
▸ postDismissAlert(): Promise
<void
>
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/alert.ts:14
proxyActive
▸ proxyActive(): boolean
Returns
boolean
Overrides
Defined in
packages/fake-driver/lib/driver.js:72
proxyCommand
▸ proxyCommand<T
>(): Promise
<T
>
Type parameters
Name | Type |
---|---|
T |
any |
Returns
Promise
<T
>
Defined in
packages/fake-driver/lib/driver.js:93
proxyReqRes
▸ proxyReqRes(req
, res
): void
Parameters
Name | Type |
---|---|
req |
any |
res |
any |
Returns
void
Defined in
packages/fake-driver/lib/driver.js:80
proxyRouteIsAvoided
▸ proxyRouteIsAvoided(sessionId
, method
, url
, body?
): boolean
Whether a given command route (expressed as method and url) should not be proxied according to this driver
Parameters
Name | Type | Description |
---|---|---|
sessionId |
string |
the current sessionId (in case the driver runs multiple session ids and requires it). This is not used in this method but should be made available to overridden methods. |
method |
HTTPMethod |
HTTP method of the route |
url |
string |
url of the route |
body? |
any |
webdriver request body |
Returns
boolean
whether the route should be avoided
Inherited from
BaseDriver.proxyRouteIsAvoided
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:145
releaseActions
▸ releaseActions(): Promise
<void
>
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/general.ts:20
reset
▸ reset(): Promise
<void
>
Reset the current session (run the delete session and create session subroutines)
Deprecated
Use explicit session management commands instead
Returns
Promise
<void
>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:31
scriptTimeoutMJSONWP
▸ scriptTimeoutMJSONWP(ms
): Promise
<void
>
Set the script timeout value that was sent in via the JSONWP
Deprecated
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
BaseDriver.scriptTimeoutMJSONWP
Defined in
packages/types/build/lib/driver.d.ts:105
scriptTimeoutW3C
▸ scriptTimeoutW3C(ms
): Promise
<void
>
Set the script timeout value that was sent in via the W3C protocol
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:98
sessionExists
▸ sessionExists(sessionId
): boolean
method required by MJSONWP in order to determine whether it should respond with an invalid session response
Parameters
Name | Type |
---|---|
sessionId |
string |
Returns
boolean
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:97
setAlertText
▸ setAlertText(text
): Promise
<void
>
Parameters
Name | Type |
---|---|
text |
string |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/alert.ts:11
setContext
▸ setContext(context
): Promise
<void
>
Parameters
Name | Type |
---|---|
context |
string |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/contexts.ts:10
setFakeThing
▸ setFakeThing(thing
): Promise
<null
>
Set the 'thing' value (so that it can be retrieved later)
Parameters
Name | Type |
---|---|
thing |
Thing |
Returns
Promise
<null
>
Defined in
packages/fake-driver/lib/driver.js:146
setFrame
▸ setFrame(frame
): Promise
<void
>
Parameters
Name | Type |
---|---|
frame |
null | number |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/contexts.ts:11
setGeoLocation
▸ setGeoLocation(location
): Promise
<Location
>
Parameters
Name | Type |
---|---|
location |
Location |
Returns
Promise
<Location
>
Defined in
packages/fake-driver/lib/commands/general.ts:11
setImplicitWait
▸ setImplicitWait(ms
): void
A helper method (not a command) used to set the implicit wait value
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the implicit wait in ms |
Returns
void
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:51
setNewCommandTimeout
▸ setNewCommandTimeout(ms
): void
Set the new command timeout
Parameters
Name | Type | Description |
---|---|---|
ms |
number |
the timeout in ms |
Returns
void
Inherited from
BaseDriver.setNewCommandTimeout
Defined in
packages/types/build/lib/driver.d.ts:36
setOrientation
▸ setOrientation(orientation
): Promise
<void
>
Parameters
Name | Type |
---|---|
orientation |
Orientation |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/general.ts:15
setProtocolMJSONWP
▸ setProtocolMJSONWP(): void
Returns
void
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:105
setProtocolW3C
▸ setProtocolW3C(): void
Returns
void
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:106
setValue
▸ setValue(keys
, value
): Promise
<void
>
Parameters
Name | Type |
---|---|
keys |
string | string [] |
value |
string |
Returns
Promise
<void
>
Defined in
packages/fake-driver/lib/commands/element.ts:15
startNewCommandTimeout
▸ startNewCommandTimeout(): Promise
<void
>
Start the timer for the New Command Timeout, which when it runs out, will stop the current session
Returns
Promise
<void
>
Inherited from
BaseDriver.startNewCommandTimeout
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:29
startUnexpectedShutdown
▸ startUnexpectedShutdown(err?
): Promise
<void
>
Signify to any owning processes that this driver encountered an error which should cause the session to terminate immediately (for example an upstream service failed)
Parameters
Name | Type | Description |
---|---|---|
err? |
Error |
the Error object which is causing the shutdown |
Returns
Promise
<void
>
Inherited from
BaseDriver.startUnexpectedShutdown
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:28
timeouts
▸ timeouts(type
, ms
, script?
, pageLoad?
, implicit?
): Promise
<void
>
Set the various timeouts associated with a session
See
https://w3c.github.io/webdriver/#set-timeouts
Parameters
Name | Type | Description |
---|---|---|
type |
string |
used only for the old (JSONWP) command, the type of the timeout |
ms |
string | number |
used only for the old (JSONWP) command, the ms for the timeout |
script? |
number |
the number in ms for the script timeout, used for the W3C command |
pageLoad? |
number |
the number in ms for the pageLoad timeout, used for the W3C command |
implicit? |
string | number |
the number in ms for the implicit wait timeout, used for the W3C command |
Returns
Promise
<void
>
Inherited from
Defined in
packages/types/build/lib/driver.d.ts:30
title
▸ title(): Promise
<string
>
Returns
Promise
<string
>
Defined in
packages/fake-driver/lib/commands/general.ts:9
updateSettings
▸ updateSettings(newSettings
): Promise
<void
>
Update the session's settings dictionary with a new settings object
Parameters
Name | Type | Description |
---|---|---|
newSettings |
StringRecord |
A key-value map of setting names to values. Settings not named in the map will not have their value adjusted. |
Returns
Promise
<void
>
Inherited from
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:48
validateDesiredCaps
▸ validateDesiredCaps(caps
): caps is DriverCaps<Object>
Validate the capabilities used to start a session
Parameters
Name | Type | Description |
---|---|---|
caps |
any |
the capabilities |
Returns
caps is DriverCaps<Object>
Whether or not the capabilities are valid
Inherited from
BaseDriver.validateDesiredCaps
Defined in
packages/base-driver/build/lib/basedriver/driver.d.ts:47
validateLocatorStrategy
▸ validateLocatorStrategy(strategy
, webContext?
): void
Parameters
Name | Type |
---|---|
strategy |
string |
webContext? |
boolean |
Returns
void
Inherited from
BaseDriver.validateLocatorStrategy
Defined in
packages/base-driver/build/lib/basedriver/core.d.ts:128
wrapNewEl
▸ wrapNewEl(obj
): Element
<string
>
Parameters
Name | Type |
---|---|
obj |
FakeElement |
Returns
Element
<string
>
Defined in
packages/fake-driver/lib/commands/find.ts:70
fakeRoute
▸ Static
fakeRoute(req
, res
): void
Parameters
Name | Type |
---|---|
req |
any |
res |
any |
Returns
void
Defined in
packages/fake-driver/lib/driver.js:222
updateServer
▸ Static
updateServer(expressApp
, httpServer
, cliArgs
): Promise
<void
>
Parameters
Name | Type |
---|---|
expressApp |
any |
httpServer |
any |
cliArgs |
any |
Returns
Promise
<void
>