udpate everything

Author: goenning

README.md

@@ -0,0 +1,45 @@
+# TypeScript + Selenium example
+
+This is a working example of using `Selenium`, `TypeScript` and `Page Object Pattern`.
+These are real test cases that run against a [Fider](http://getfider.com) instance.
+Check out a running example of the application at [http://demo.fider.io](http://demo.fider.io).
+
+The tests are available in both TDD and BDD style.
+
+# How it works
+
+```
+.
+├── lib/
+├── pages/
+├── specs/
+├── tests/
+└── config.ts
+```
+
+- `lib`: Think of this as a "framework". Ideally should be a separate module distributed on `npm`;
+- `pages`: These are your `Page Object` models. Each Page of your application should have a PageObject that maps all the elements and actions.
+- `specs`: All your BDD-style tests goes here
+- `tests`: All your TDD-style/classic tests goes here
+- `config.ts`: General configuration and settings that are read by tests.
+
+## Test Case #1: Unauthenticated cannot submit ideas
+
+`Unauthenticated users` should NOT be see `Description field` and `Submit button` after typing the title.
+
+## Test Case #2: Authenticated can submit ideas
+
+`Authenticated users` should be able to submit new ideas by clicking on `Submit button` after typing the title.
+After new idea is submitted, user should be redirect to the new idea's display page.
+
+# See the tests
+
+- TDD: [test.ts](specs/spec.ts)
+- BDD: [spec.ts](tests/test.ts)
+
+# TODO:
+
+Write about How it works (- TDD (tests) or BDD (specs) style, differences, - @findBy decorator)
+Write about benefits like (- Both use same objects, - Tests are decoupled from UI, - Easy to write new tests by reusing Page objects)
+
+explain each folder

config.ts

@@ -0,0 +1,11 @@
+const config = {
+  baseUrl: process.env.BASE_URL || 'http://demo.dev.fider.io:3000',
+  users: {
+    darthvader: {
+      email: 'darthvader.fider@gmail.com',
+      password: process.env.DARTHVADER_PASSWORD!,
+    },
+  },
+};
+
+export default config;

lib/browser.ts

@@ -1,10 +1,7 @@
-require('chromedriver');
-
-import { Builder, ThenableWebDriver, WebElement, By, WebElementPromise, promise } from 'selenium-webdriver';
+import 'chromedriver';
+import { Builder, ThenableWebDriver, WebElement, By, WebElementPromise } from 'selenium-webdriver';
 import { NewablePage, Page } from './page';
 
-export { WebElementPromise };
-
 export class Browser {
   private driver: ThenableWebDriver;
   public constructor(private browserName: string) {

lib/ensure.ts

@@ -0,0 +1,35 @@
+import { WebElementPromise } from 'selenium-webdriver';
+
+class Ensurer {
+  private selector: string;
+  constructor(private element: WebElementPromise) {
+    this.selector = (this.element as any).selector;
+  }
+
+  public async textIs(expected: string) {
+    const text = await this.element.getText();
+
+    if (expected.trim() !== text.trim()) {
+      throw new Error(`Element ${this.selector} text is '${text}'. Expected value is '${expected}'`);
+    }
+  }
+
+  public async isNotVisible() {
+    let displayed = false;
+    const selector = (this.element as any).selector;
+
+    try {
+      displayed = await this.element.isDisplayed();
+    } catch (ex) {
+      displayed = false;
+    }
+
+    if (displayed) {
+      throw new Error(`Element ${this.selector} is visible`);
+    }
+  }
+}
+
+export const ensure = (element: WebElementPromise) => {
+  return new Ensurer(element);
+};

lib/index.ts

@@ -1,3 +1,5 @@
 export * from './page';
 export * from './browser';
 export * from './utils';
+export * from './ensure';
+export { WebElementPromise } from 'selenium-webdriver';

lib/mocha-bdd.ts

@@ -0,0 +1,15 @@
+import { ISuiteCallbackContext } from 'mocha';
+
+export const specification = (name: string, callback: (this: ISuiteCallbackContext) => void) => {
+  return describe(`Specification: ${name}`, callback);
+};
+
+export const when = (condition: string, callback: (this: ISuiteCallbackContext) => void) => {
+  return describe(`when ${condition}`, callback);
+};
+
+export const then = (condition: string, callback: (this: ISuiteCallbackContext) => void) => {
+  return it(`then ${condition}`, callback);
+};
+
+export const action = before;

lib/mocha.ts

@@ -8,7 +8,9 @@ export function findBy(selector: string) {
         configurable: true,
         enumerable: true,
         get: function() {
-          return (this as any).browser.findElement(selector);
+          const promise = (this as any).browser.findElement(selector);
+          promise.selector = selector;
+          return promise;
         },
     });
   };

lib/utils.ts

@@ -4,17 +4,16 @@
   "description": "",
   "main": "index.js",
   "scripts": {
-    "test": "rm -rf dist && tsc && mocha -t 10000 dist/specs"
+    "tdd": "rm -rf dist && tsc && mocha -t 10000 dist/tests",
+    "bdd": "rm -rf dist && tsc && mocha -t 10000 dist/specs"
   },
   "keywords": [],
-  "author": "",
+  "author": "Guilherme Oenning",
   "license": "ISC",
   "devDependencies": {
-    "@types/chai": "^4.0.1",
     "@types/mocha": "^2.2.41",
     "@types/node": "^8.0.6",
     "@types/selenium-webdriver": "^3.0.4",
-    "chai": "^4.0.2",
     "chromedriver": "^2.30.1",
     "mocha": "^3.4.2",
     "selenium-webdriver": "^3.4.0",