e2e: use 'samplestack.local' domain for sauce

SauceLabs uses a not-fully-reliable, slow proxy solution to work around
issues with testing remotely against localhost domain in Internet
Explorer (and Safari).

- Use 'samplestack.local' domain for Sauce-based e2e tests.
- Configure this domain in travis.
- Update readme with instruction.

BREAKING CHANGE: users will need to configure such a domain, typically
in their hosts file, to point to 127.0.0.1

Closes #452

Author: laurelnaiad

.travis.yml

@@ -1,5 +1,9 @@
 language: java
 
+addons:
+  hosts:
+    - samplestack.local
+
 # for non-pull-requests, aka pushes, requires secure emvironment
 # variables for access to MarkLogic nightlies (when applicable)
 # and for SauceLabs integration. These are configured in

browser/README.md

@@ -167,6 +167,9 @@ Note on `~@broken`: always specify this flag unless you are interested in seeing
 are known to be broken. Such tests are also flagged in the feature files with issue id numbers, so
 that they may be executed individually based on the issue that covers the problem.
 
+**Note: to use SauceLabs tests, please add a hosts file entry (or other domain resolution) that points "samplestack.local" to 127.0.0.1 on your machine.**
+The reasons for this are documented in https://support.saucelabs.com/entries/27401240-Testing-with-a-localhost-server-and-some-browsers-can-t-load-my-website .
+
 ## Node.js/npm Tips and Troubleshooting
 
 Please see [Node.js and npm Tips for Samplestack Development](https://github.com/marklogic/marklogic-samplestack/wiki/Node.js-and-npm-Tips-for-Samplestack-Development).

browser/dev-tasks/e2e/protractor.js

@@ -37,6 +37,13 @@ var ptorConfig = {
 
 
 var go = function (args, cb) {
+  // sauce/IE doens't like "localhost", so we punt.
+  // running on Sauce now requires this hosts file entry
+  if (args.sauce) {
+    ptorConfig.baseUrl =
+    ptorConfig.baseUrl.replace('localhost', 'samplestack.local');
+  }
+
   if (args.tags) {
     ptorConfig.cucumberOpts.tags = [args.tags];
   }