Integrates jest-puppeteer for UI testing

.travis.yml

@@ -6,4 +6,6 @@ before_install:
   - npm install -g grunt-cli
 before_script:
   - grunt build
-script: grunt jasmine --force
+script: 
+  - grunt jasmine --force
+  - npm run test-ui

README.md

@@ -320,14 +320,26 @@ For additional support, join the Public Lab website and mailing list at http://p
 
 ## Testing
 
-Automated tests are an essential way to ensure that new changes don't break existing functionality, and can help you be confident that your code is ready to be merged in. We use Jasmine for testing: https://jasmine.github.io/2.4/introduction.html
+Automated tests are an essential way to ensure that new changes don't break existing functionality, and can help you be confident that your code is ready to be merged in. We use Jasmine for testing: https://jasmine.github.io/2.4/introduction.html. The UI tests are written using jest and puppeteer. 
+
+The combined tests are run using `npm run test`.
 
 To run tests, open /test.html in a browser. If you have phantomjs installed, you can run `grunt jasmine` to run tests on the commandline.
 
 You can find the installation instructions for phantomjs in its official [build documentation](http://phantomjs.org/build.html). For Ubuntu/debian based system you can follow [these instructions](https://gist.github.com/julionc/7476620) or use the script mentioned there.
 
 To add new tests, edit the `*_spec.js` files in `/spec/javascripts/`.
 
+To run the UI tests you can run `npm run test-ui`. To add new tests, edit the  `*test.js` files in `/test/ui-testing/`. 
+
+If you face any error while running UI tests:
+
+1. Make sure you're not running them as a root user. If running them as a root user include args: ['--no-sandbox'] in jest-puppeteer.config.js (not recommended).
+2. Make sure you have all the required dependencies installed.
+For Debian systems:
+`sudo apt-get install gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget`
+3. Upgrade your kernel.
+
 
 ****
 

jest-puppeteer.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+    launch: {
+        headless: process.env.HEADLESS !== 'false',
+        slowMo: process.env.SLOWMO ? process.env.SLOWMO : 0,
+        devtools: true
+    }
+}

jest.config.js

@@ -0,0 +1,10 @@
+module.exports = {
+  preset: "jest-puppeteer",
+  globals: {
+    URL: "http://localhost:8080"
+  },
+  testMatch: [
+    "**/test/**/*.test.js"
+  ],
+  verbose: true
+}