Updated Readme and script for SauceLabs testing

Change-Id: I19b12a4aa5da38c9d8a12438b167ea40c4967f46

Author: Thomas Cesare-Herriau

README.md

@@ -662,6 +662,32 @@ Then, all unit tests can be run at: http://localhost:4000/buildtools/all_tests.h
 You can also run tests individually by accessing each HTML file under
 `generated/tests`, for example: http://localhost:4000/generated/tests/javascript/widgets/authui_test.html
 
+### Run tests using SauceLabs
+
+*You need a [SauceLabs](https://saucelabs.com/) account to run tests on
+SauceLabs.*
+
+Go to your SauceLab account, under "My Account", and copy paste the access key.
+Now export the following variables, *in two Terminal windows*:
+
+```bash
+export SAUCE_USERNAME=<your username>
+export SAUCE_ACCESS_KEY=<the copy pasted access key>
+```
+
+ Then, in one Terminal window, start SauceConnect:
+
+ ```bash
+./buildtools/sauce_connect.sh
+```
+
+Take note of the "Tunnel Identifier" value logged in the terminal,at the top. In
+the other terminal that has the exported variables, run the tests:
+
+```bash
+npm test -- --saucelabs --tunnelIdentifier=<the tunnel identifier>
+```
+
 ## Known issues
 
 ### Firebase Auth does not work in Safari private browsing

buildtools/sauce_connect.sh

@@ -48,7 +48,13 @@ trap removeFiles EXIT
 
 # This will be used by Protractor to connect to SauceConnect.
 TUNNEL_IDENTIFIER="tunnelId-$RANDOM"
-echo "Tunnel Identifier: $TUNNEL_IDENTIFIER"
+echo ""
+echo "========================================================================="
+echo "    Tunnel Identifier to pass to Protractor:"
+echo "    $TUNNEL_IDENTIFIER"
+echo "========================================================================="
+echo ""
+echo ""
 
 echo "Starting Sauce Connect..."
 

protractor.conf.js

@@ -32,7 +32,7 @@
  * $ ./buildtools/sauce_connect.sh
  * Take note of the "Tunnel Identifier" value logged in the terminal.
  * Run the tests:
- * $ npm run -- --saucelabs --tunnelIdentifier=<the tunnel identifier>
+ * $ npm test -- --saucelabs --tunnelIdentifier=<the tunnel identifier>
  * This will start the HTTP Server locally, and connect through SauceConnect
  * to SauceLabs remote browsers instances.
  *
@@ -83,6 +83,10 @@ if (options.saucelabs) {
   // SauceLabs configuration.
   config.sauceUser = process.env.SAUCE_USERNAME;
   config.sauceKey = process.env.SAUCE_ACCESS_KEY;
+  if (!config.sauceKey || !config.sauceUser) {
+    throw 'The SAUCE_USERNAME and SAUCE_ACCESS_KEY environment variables have '+
+        ' to be set.';
+  }
   // Avoid going over the SauceLabs concurrency limit (5).
   config.maxSessions = 5;
   // List of browsers configurations tested.