Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    webdriver-rtpublic

    Features

    • Run plain English test case as a test
    • Built-in chromedriver, firefox driver, and reporter
    • No need to run a selenium-server standalone jar file
    • Ability to control execution speed
    • Angular2-Friendly without Protractor

    Install

    • npm install webdriver-tt

    Usage

    • node_modules/webdriver-tt/bin my-test-case.txt

    Test Case File Example

    My Test Scenario
      My Test Case
        open /login
        enter 'John' into 'username'
        enter 'secret' into 'password'
        see 'successful'
    

    Selenuim WebDriver is great! .......... But, it's not that easy for a beginner who does not understand full concept of Promise used in there.

    For example, the following test code does make sense, but it will only work if you are super lucky;

    var webdriver = require('selenium-webdriver'),
        until = webdriver.until;
    
    var driver = new webdriver.Builder().forBrowser('firefox').build();
    
    driver.get('https://run.plnkr.co/plunks/aWTZswhBnUVLg7qyDr83/');
    driver.findElement({css:'input'}).then(function(element) {
      element.sendKeys('Cheese!');
      element.getAttribute('value').then(function(str) {
        console.log('str', str); 
      });
    });;
    
    driver.quit();
    

    You may get this error very easily, NoSuchElementError: Unable to locate element.

    /Users/allen/github/webdriver-tt/node_modules/selenium-webdriver/lib/promise.js:654
        throw error;
        ^
    
    NoSuchElementError: Unable to locate element: {"method":"css selector","selector":"input"}
    

    The reason is not only about timeout, but also every about implicit wait instruction is not executed insequence.

    This pain grows when we deal with Angular, especially Angular2. That might be the reason protractor is invented. However, even with protractor, timeout error, implicit and explicit wait still comes time to time, makes successful tests very inconsistent.

    WebDriver has very nice feature of wait/until to resolve things before to go further tests. We can change it to use explicit wait by using driver.wait and webdriver.until, but almost all hates to deal with chainging these properly, and even properly chained code is not so maintainable.

    wait syntax

    driver.wait(CONDITION, MS);
    

    We can combine this syntax with driver.until. conditions. For example,

    driver.until.elementIsVisible({css: '.my-class'})
    

    The problem is that we can do only once. The following code is not guranteed to run in sequence

    driver.wait(CONDITION1, 2000).then(function() { console.log(1) });
    driver.wait(CONDITION2, 2000).then(function() { console.log(2) });
    driver.wait(CONDITION3, 2000).then(function() { console.log(3) });
    

    To make it really sequenctial, we need to code like the following

    driver.get('http://www.primefaces.org/primeng/#/autocomplete');
    
    driver.wait(until.elementLocated({css:"h3.first"}), 20000).then(function() {
     console.log(1);
    }).then(function() {
      driver.wait(until.elementLocated({css:"div"}), 20000).then(function() {
       console.log(2);
     })
    }).then(function() {
      driver.wait(until.elementLocated({css:"body"}), 20000).then(function() {
       console.log(3);
     })
    })
    

    Although the above code works, the repeativive function(), then, and { ..} makes people not to focus on test, but the Javascript promise syntax.

    webdriver-tt is designed to focus on test cases, not Javascript syntax by genrating promise-chained then..then..then..then..then.. code from clean test cases.

    These are pattern of commands

    • open browser {{URL}}
    • visit {{URL}}
    • find {{ELEMENT}}
    • enter {{STRING}} into {{ELEMENT}}
    • click {{ELEMENT}}
    • wait until alert is present
    • wait until {{ELEMENT}} present
    • wait until {{ELEMENT}} is (not) visible
    • wait until {{ELEMENT}} is (en|dis)abled
    • wait until {{ELEMENT}} is (not) selected

    Keywords

    none

    install

    npm i webdriver-rt

    Downloadsweekly downloads

    0

    version

    0.1.0

    license

    ISC

    repository

    github.com

    last publish

    collaborators

    • avatar