|
| 1 | +# browserstack-local-java |
| 2 | + |
| 3 | +## Setup |
| 4 | + |
| 5 | +``` |
| 6 | +mvn install browserstack-local |
| 7 | +``` |
| 8 | + |
| 9 | +## API |
| 10 | + |
| 11 | +### Constructor |
| 12 | + |
| 13 | +* `new BrowserStack::Local`: creates an instance of Local |
| 14 | + |
| 15 | +### Methods |
| 16 | + |
| 17 | +* `start(options)`: starts Local instance with options. The options available are detailed below. |
| 18 | +* `stop()`: stops the Local instance |
| 19 | +* `isRunning()`: checks if Local instance is running |
| 20 | + |
| 21 | +### Options |
| 22 | + |
| 23 | +* `key`: BrowserStack Access Key |
| 24 | +* `v`: Provides verbose logging |
| 25 | +* `f`: If you want to test local folder rather internal server, provide path to folder as value of this option |
| 26 | +* `force`: Kill other running Browserstack Local |
| 27 | +* `only`: Restricts Local Testing access to specified local servers and/or folders |
| 28 | +* `forcelocal`: Route all traffic via local machine |
| 29 | +* `onlyAutomate`: Disable Live Testing and Screenshots, just test Automate |
| 30 | +* `proxyHost`: Hostname/IP of proxy, remaining proxy options are ignored if this option is absent |
| 31 | +* `proxyPort`: Port for the proxy, defaults to 3128 when -proxyHost is used |
| 32 | +* `proxyUser`: Username for connecting to proxy (Basic Auth Only) |
| 33 | +* `proxyPass`: Password for USERNAME, will be ignored if USERNAME is empty or not specified |
| 34 | +* `localIdentifier`: If doing simultaneous multiple local testing connections, set this uniquely for different processes |
| 35 | +* `hosts`: List of hosts and ports where Local must be enabled for eg. localhost,3000,1,localhost,3001,0 |
| 36 | +* `logfile`: Path to file where Local logs be saved to |
| 37 | +* `binarypath`: Optional path to Local binary |
| 38 | + |
| 39 | + |
| 40 | +## Build |
| 41 | + |
| 42 | +To build gem, `mvn compile`. |
| 43 | + |
| 44 | + |
| 45 | +## Tests |
| 46 | + |
| 47 | +To run the test suite run, `mvn test`. |
0 commit comments