catjsrunner
v0.3.8
Published
CATJS runner is a command line tool that helps you run your web application on multiple devices including, Android, iOS, and PC browsers. This tool is very useful when combined with mobile web automation frameworks like [catjs](https://www.npmjs.org/pack
Downloads
9
Readme
CATJS Runner
CATJS runner is a command line tool that helps you run your web application on multiple devices including, Android, iOS, and PC browsers. This tool is very useful when combined with mobile web automation frameworks like catjs.
Release Notes
- Runner information API (Actual and Configuration) with errors in case the devices or browsers failed to be opened
- Console notification in case the connection of an iphone device request fails
##Installation
We recommend to install mobilerunner as a cli
npm install -g mobilerunner
Command line syntax:
mobilerunner <configfile>
If omitted the mobilerunner will search for a config file named TestRunConfig.json in the working directory.
Support
browsers Currently supported browsers names for cross platform (Linux, Darwin and win32):
- firefox
- safari
- chrome
- others In case you wish to open other browser just set the name with the application's name
We are using "open" module for staring the applications
iPhone agent application will be supported later on
android agent application is supported and is part of the module installation
##Config file
The config file is a json file with the following properties:
devices An array that defines the devices
- disable [true | false] Whether to disable the device
- type The type of device [localpc | android | iphone | androidBrowser]
- runner The configuration of the device's runner
- name In case of 'localpc' it is the name of the application e.g browser types [chrome | firefox | safari]
- address (optional) The application's path after the base url domain
- options (optional)
- androidBrowser Open a chrome browser
- localpc
- path of the browser, if omitted the default installation will be used
- instances to be opened per browser
- android
- path of the apk runner (provided with this package), the default path is
./lib/resources
- path of the apk runner (provided with this package), the default path is
- iphone
- ip address of the device
- port the agent's port
- ip address of the device
server The server configuration that will be used for the base URL
- host Defaults set to "auto" (localhost)
- port The server request port
- method The server request method
Android Chrome Browser example
{
"run": {
"devices": [
{
"disable": false,
"type": "androidBrowser",
"id": "all",
"runner": {
"name": "chrome",
"address": ""
}
}
]
}
"server": {
"host" : "www.google.com",
"port" : "80"
}
}
Fuul Config file examples
{
"run": {
"devices": [
{
"disable": false,
"type": "androidBrowser",
"id": "all",
"runner": {
"name": "chrome",
"address": "/index.html"
}
},
{
"disable": false,
"type": "localpc",
"runner": {
"name": "chrome",
"address": "/index.html",
"options": {"instances":1}
}
},
{
"disable": false,
"type": "localpc",
"runner": {
"name": "firefox",
"address": "/index.html",
"options": {"instances":1}
}
},
{
"disable": true,
"type": "android",
"id": "all",
"runner": {
"name": "apk",
"options": {"path" :"./lib/resources"}
}
},
{
"disable": true,
"type": "iphone",
"id": "all",
"runner": {
"name": "agent",
"options": {"ip": "192.168.1.107", "port": "54321", "path": "/cat", "timeout": 20000}
}
}
]
}
"server": {
"host" : "auto",
"port" : "8089"
}
}