Make Selenium Helper file more resemble GUI and Update Tests to use it

test/integration/selenium-helpers.js

@@ -1,10 +1,37 @@
 const webdriver = require('selenium-webdriver');
+const bindAll = require('lodash.bindall');
 
 const headless = process.env.SMOKE_HEADLESS || false;
 const remote = process.env.SMOKE_REMOTE || false;
 const {SAUCE_USERNAME, SAUCE_ACCESS_KEY} = process.env;
+const {By, until} = webdriver;
 
-const getDriver = function () {
+class SeleniumHelper {
+    constructor () {
+        bindAll(this, [
+            'getDriver',
+            'getSauceDriver',
+            'buildDriver',
+            'clickXpath',
+            'findByXpath',
+            'clickText',
+            'findText',
+            'clickButton',
+            'findByCss',
+            'clickCss',
+            'getLogs'
+        ]);
+    }
+    buildDriver (name) {
+        if (remote === 'true'){
+            this.driver = this.getSauceDriver(SAUCE_USERNAME, SAUCE_ACCESS_KEY, name);
+        } else {
+            this.driver = this.getDriver();
+        }
+        return this.driver;
+    }
+
+    getDriver () {
         const chromeCapabilities = webdriver.Capabilities.chrome();
         let args = [];
         if (headless) {
@@ -13,74 +40,66 @@ const getDriver = function () {
             args.push('--no-sandbox');
         }
         chromeCapabilities.set('chromeOptions', {args});
-    const newDriver = new webdriver.Builder()
+        let driver = new webdriver.Builder()
             .forBrowser('chrome')
             .withCapabilities(chromeCapabilities)
             .build();
-    return newDriver;
+        return driver;
-};
+    }
 
-const getSauceDriver = function (username, accessKey, configs) {
+    getSauceDriver (username, accessKey, name) {
-    let driver = new webdriver.Builder()
+        // Driver configs can be generated with the Sauce Platform Configurator
+        // https://wiki.saucelabs.com/display/DOCS/Platform+Configurator
+        let driverConfig = {
+            browserName: 'chrome',
+            platform: 'macOS 10.13',
+            version: '67.0'
+        };
+        var driver = new webdriver.Builder()
             .withCapabilities({
-            browserName: configs.browserName,
+                browserName: driverConfig.browserName,
-            platform: configs.platform,
+                platform: driverConfig.platform,
-            version: configs.version,
+                version: driverConfig.version,
                 username: username,
                 accessKey: accessKey,
-            name: 'smoke test scratch-www'
+                name: name
             })
             .usingServer(`http://${username}:${accessKey
             }@ondemand.saucelabs.com:80/wd/hub`)
             .build();
         return driver;
-};
+    }
-// Driver configs can be generated with the Sauce Platform Configurator
-// https://wiki.saucelabs.com/display/DOCS/Platform+Configurator
-const driverConfig = {
-    browserName: 'chrome',
-    platform: 'macOS 10.13',
-    version: '67.0'
-};
-let driver;
-if (remote === 'true'){
-    driver = getSauceDriver(SAUCE_USERNAME, SAUCE_ACCESS_KEY, driverConfig);
-} else {
-    driver = getDriver();
-}
 
-const {By, until} = webdriver;
+    findByXpath (xpath) {
+        return this.driver.wait(until.elementLocated(By.xpath(xpath), 5 * 1000));
+    }
 
-const findByXpath = (xpath) => {
+    clickXpath (xpath) {
-    return driver.wait(until.elementLocated(By.xpath(xpath), 5 * 1000));
+        return this.findByXpath(xpath).then(el => el.click());
-};
+    }
 
-const clickXpath = (xpath) => {
+    clickText (text) {
-    return findByXpath(xpath).then(el => el.click());
+        return this.clickXpath(`//*[contains(text(), '${text}')]`);
-};
+    }
 
-const clickText = (text) => {
+    findText (text) {
-    return clickXpath(`//*[contains(text(), '${text}')]`);
+        return this.driver.wait(until.elementLocated(By.xpath(`//*[contains(text(), '${text}')]`), 5 * 1000));
-};
+    }
 
-const findText = (text) => {
+    clickButton (text) {
-    return driver.wait(until.elementLocated(By.xpath(`//*[contains(text(), '${text}')]`), 5 * 1000));
+        return this.clickXpath(`//button[contains(text(), '${text}')]`);
-};
+    }
 
-const clickButton = (text) => {
+    findByCss (css) {
-    return clickXpath(`//button[contains(text(), '${text}')]`);
+        return this.driver.wait(until.elementLocated(By.css(css), 1000 * 5));
-};
+    }
 
-const findByCss = (css) => {
+    clickCss (css) {
-    return driver.wait(until.elementLocated(By.css(css), 1000 * 5));
+        return this.findByCss(css).then(el => el.click());
-};
+    }
 
-const clickCss = (css) => {
+    getLogs (whitelist) {
-    return findByCss(css).then(el => el.click());
+        return this.driver.manage()
-};
-
-const getLogs = (whitelist) => {
-    return driver.manage()
             .logs()
             .get('browser')
             .then((entries) => {
@@ -101,21 +120,8 @@ const getLogs = (whitelist) => {
                     return true;
                 });
             });
-};
+    }
 
-module.exports = {
+}
-    webdriver,
+
-    By,
+module.exports = SeleniumHelper;
-    until,
-    driver,
-    clickXpath,
-    findByXpath,
-    clickText,
-    findText,
-    clickButton,
-    findByCss,
-    clickCss,
-    getLogs,
-    getDriver,
-    getSauceDriver
-};

test/integration/smoke-testing/test-login-failures.js

@@ -1,17 +1,22 @@
-const {
+const SeleniumHelper = require('../selenium-helpers.js');
-    driver,
+const helper = new SeleniumHelper();
-    findByCss,
-    clickCss,
-    until
-} = require('../selenium-helpers.js');
-
-var username = process.env.SMOKE_USERNAME;
-var password = process.env.SMOKE_PASSWORD;
-
 
 var tap = require('tap');
 const test = tap.test;
 
+const webdriver = require('selenium-webdriver');
+const driver = helper.buildDriver('www-smoke test-login-failures');
+
+const {
+    findByCss,
+    clickCss
+} = helper;
+
+var until = webdriver.until;
+
+var username = process.env.SMOKE_USERNAME;
+var password = process.env.SMOKE_PASSWORD;
+
 var rootUrl = process.env.ROOT_URL || 'https://scratch.ly';
 var url = rootUrl + '/users/' + username;
 

test/integration/smoke-testing/test-my-stuff.js

@@ -5,21 +5,24 @@
  *
  */
 
+const SeleniumHelper = require('../selenium-helpers.js');
+const helper = new SeleniumHelper();
+
+var tap = require('tap');
+const test = tap.test;
+
+const driver = helper.buildDriver('www-smoke test-my-stuff');
+
 const {
     clickText,
     findByXpath,
     clickXpath,
-    clickButton,
+    clickButton
-    driver
+} = helper;
-} = require('../selenium-helpers.js');
 
 var username = process.env.SMOKE_USERNAME;
 var password = process.env.SMOKE_PASSWORD;
 
-
-var tap = require('tap');
-const test = tap.test;
-
 var rootUrl = process.env.ROOT_URL || 'https://scratch.ly';
 var url = rootUrl + '/users/' + username;
 

test/integration/smoke-testing/test_footer_links.js

@@ -4,12 +4,13 @@
  * Test cases: https://github.com/LLK/scratch-www/wiki/Most-Important-Workflows
  */
 
+const SeleniumHelper = require('../selenium-helpers.js');
+const helper = new SeleniumHelper();
+
 const tap = require('tap');
 
-const {
+const webdriver = require('selenium-webdriver');
-    driver,
+const driver = helper.buildDriver('www-smoke test_footer_links');
-    webdriver
-} = require('../selenium-helpers.js');
 
 
 const rootUrl = process.env.ROOT_URL || 'https://scratch.ly';

test/integration/smoke-testing/test_navbar_links.js

@@ -4,14 +4,14 @@
  * Test cases: https://github.com/LLK/scratch-www/wiki/Most-Important-Workflows
  */
 
-require('chromedriver');
+const SeleniumHelper = require('../selenium-helpers.js');
+const helper = new SeleniumHelper();
 
-const {
-    driver,
-    webdriver
-} = require('../selenium-helpers.js');
 var tap = require('tap');
 
+const webdriver = require('selenium-webdriver');
+const driver = helper.buildDriver('www-smoke test_navbar_links');
+
 // Set test url through environment variable
 var rootUrl = process.env.ROOT_URL || 'https://scratch.ly';
 

test/integration/smoke-testing/test_project_rows.js

@@ -5,13 +5,14 @@
  * Test cases: https://github.com/LLK/scratch-www/wiki/Most-Important-Workflows
  */
 
-require('chromedriver');
+const SeleniumHelper = require('../selenium-helpers.js');
-var tap = require('tap');
+const helper = new SeleniumHelper();
-var seleniumWebdriver = require('selenium-webdriver');
+
+var tap = require('tap');
+
+const webdriver = require('selenium-webdriver');
+const driver = helper.buildDriver('www-smoke test_project_rows');
 
-const {
-    driver
-} = require('../selenium-helpers.js');
 
 var rootUrl = process.env.ROOT_URL || 'https://scratch.ly';
 
@@ -31,7 +32,7 @@ tap.beforeEach(function () {
 // checks that the title of the first row is Featured Projects
 tap.test('checkFeaturedProjectsRowTitleWhenSignedOut', function (t) {
     var xPathLink = '//div[@class="box"]/div[@class="box-header"]/h4';
-    driver.findElement(seleniumWebdriver.By.xpath(xPathLink))
+    driver.findElement(webdriver.By.xpath(xPathLink))
         .then(function (element) {
             element.getText('h4')
                 .then(function (text) {
@@ -48,8 +49,8 @@ tap.test('checkFeaturedProjectsRowLinkWhenSignedOut', function (t) {
     var xPathLink = '//div[contains(@class, "thumbnail") ' +
         'and contains(@class, "project") and contains(@class, "slick-slide") ' +
         'and contains(@class, "slick-active")]/a[@class="thumbnail-image"]';
-    driver.wait(seleniumWebdriver.until
+    driver.wait(webdriver.until
-        .elementLocated(seleniumWebdriver.By.xpath(xPathLink)))
+        .elementLocated(webdriver.By.xpath(xPathLink)))
         .then(function (element) {
             element.getAttribute('href')
                 .then(function (url) {
@@ -65,7 +66,7 @@ tap.test('checkFeaturedProjectsRowLinkWhenSignedOut', function (t) {
 // checks that the title of the 2nd row is Featured Studios
 tap.test('checkFeaturedStudiosRowWhenSignedOut', function (t) {
     var xPathLink = '//div[@class="box"][2]/div[@class="box-header"]/h4';
-    driver.findElement(seleniumWebdriver.By.xpath(xPathLink))
+    driver.findElement(webdriver.By.xpath(xPathLink))
         .then(function (element) {
             element.getText('h4')
                 .then(function (text) {
@@ -80,7 +81,7 @@ tap.test('checkFeaturedStudiosRowWhenSignedOut', function (t) {
 tap.test('checkFeaturedStudiosRowLinkWhenSignedOut', function (t) {
     var xPathLink = '//div[contains(@class, "thumbnail") and contains(@class, "gallery") ' +
         'and contains(@class, "slick-slide") and contains(@class, "slick-active")]/a[@class="thumbnail-image"]';
-    driver.findElement(seleniumWebdriver.By.xpath(xPathLink))
+    driver.findElement(webdriver.By.xpath(xPathLink))
         .then(function (element) {
             element.getAttribute('href')
                 .then(function (url) {

test/integration/smoke-testing/test_signing_in_and_out_discuss.js

@@ -5,22 +5,25 @@
  *
  */
 
+const SeleniumHelper = require('../selenium-helpers.js');
+const helper = new SeleniumHelper();
+
+var tap = require('tap');
+const test = tap.test;
+
+const driver = helper.buildDriver('www-smoke test_sign_in_out_discuss');
+
 const {
     clickText,
     findByXpath,
     findText,
     clickXpath,
-    clickButton,
+    clickButton
-    driver
+} = helper;
-} = require('../selenium-helpers.js');
 
 var username = process.env.SMOKE_USERNAME;
 var password = process.env.SMOKE_PASSWORD;
 
-
-var tap = require('tap');
-const test = tap.test;
-
 var rootUrl = process.env.ROOT_URL || 'https://scratch.ly';
 var url = rootUrl + '/discuss';
 

test/integration/smoke-testing/test_signing_in_and_out_homepage.js

@@ -5,20 +5,24 @@
  *
  */
 
+const SeleniumHelper = require('../selenium-helpers.js');
+const helper = new SeleniumHelper();
+
+var tap = require('tap');
+const test = tap.test;
+
+const driver = helper.buildDriver('www-smoke test_sign_in_out_homepage');
+
 const {
     clickText,
     findText,
     findByXpath,
-    clickXpath,
+    clickXpath
-    driver
+} = helper;
-} = require('../selenium-helpers.js');
 
 var username = process.env.SMOKE_USERNAME;
 var password = process.env.SMOKE_PASSWORD;
 
-var tap = require('tap');
-const test = tap.test;
-
 var rootUrl = process.env.ROOT_URL || 'https://scratch.ly';
 
 tap.plan(2);

test/integration/smoke-testing/test_statistics_page.js

@@ -5,16 +5,20 @@
  *
  */
 
-const {
+const SeleniumHelper = require('../selenium-helpers.js');
-    clickText,
+const helper = new SeleniumHelper();
-    findByXpath,
-    findByCss,
-    driver
-} = require('../selenium-helpers.js');
 
 var tap = require('tap');
 const test = tap.test;
 
+const driver = helper.buildDriver('www-smoke test_statistics_page');
+
+const {
+    clickText,
+    findByXpath,
+    findByCss
+} = helper;
+
 tap.plan(2);
 
 tap.tearDown(function () {