Browserstack guard
A cli command checking the available executors on your browserstack subscription.
Background
Browserstack supports limited number of queued tasks. If you run a test when the queue is already full, the test will fail. This command helps you check if it is possible to run a new test. If you have reached the upper limit of allowed parallel tests, the command will wait until an executor becomes available.
Install
Just install the package as a global package on your system
npm install -g browserstack-guard
How to use
Before you run any test on browserstack, run the following command:
browserstack-guard --username <user name> --accesskey <access key>
or
BROWSERSTACK_USERNAME=<user name> BROWSERSTACK_ACCESS_KEY=<access key> browserstack-guard
This could be very handy to run before you start any automated test in the build pipeline.
Contributing
Pull requests are welcome for fixing issues or adding more features. Things that could be useful are unit tests and more safety nets for when something goes wrong.