jasminewd2

What is jasminewd2?

The jasminewd2 package is a bridge between Jasmine and WebDriverJS, allowing for seamless integration of asynchronous WebDriverJS commands in Jasmine tests. It provides utilities to handle promises and asynchronous operations in a more readable and manageable way.

What are jasminewd2's main functionalities?

Asynchronous Testing

This feature allows you to write tests that wait for promises to resolve before making assertions. The code sample demonstrates how to navigate to a URL and then check the page title, ensuring that the test waits for the navigation to complete.

describe('Asynchronous specs', function() {
  it('should wait for the promise to resolve', function() {
    return browser.get('http://www.example.com').then(function() {
      expect(browser.getTitle()).toEqual('Example Domain');
    });
  });
});

Custom Matchers

This feature allows you to define custom matchers to extend Jasmine's built-in matchers. The code sample shows how to create a custom matcher `toBeWithinRange` that checks if a number falls within a specified range.

describe('Custom matchers', function() {
  beforeEach(function() {
    jasmine.addMatchers({
      toBeWithinRange: function() {
        return {
          compare: function(actual, expected) {
            var result = {};
            result.pass = actual >= expected[0] && actual <= expected[1];
            if (result.pass) {
              result.message = 'Expected ' + actual + ' to be within range ' + expected;
            } else {
              result.message = 'Expected ' + actual + ' to be within range ' + expected + ' but it was not';
            }
            return result;
          }
        };
      }
    });
  });

  it('is within range', function() {
    expect(100).toBeWithinRange([90, 110]);
  });
});

Handling Asynchronous Setup and Teardown

This feature allows you to perform asynchronous operations in setup and teardown functions. The code sample demonstrates how to navigate to a URL before all tests and quit the browser after all tests, ensuring that these operations complete before proceeding.

describe('Asynchronous setup and teardown', function() {
  beforeAll(function(done) {
    browser.get('http://www.example.com').then(function() {
      done();
    });
  });

  afterAll(function(done) {
    browser.quit().then(function() {
      done();
    });
  });

  it('should have a title', function() {
    expect(browser.getTitle()).toEqual('Example Domain');
  });
});

Other packages similar to jasminewd2

protractor

Protractor is an end-to-end test framework for Angular and AngularJS applications. It is built on top of WebDriverJS and integrates seamlessly with Jasmine, providing additional features like automatic waiting and Angular-specific locators. Compared to jasminewd2, Protractor offers a more comprehensive solution for testing Angular applications.

webdriverio

WebdriverIO is a popular WebDriver binding for Node.js. It supports various test frameworks, including Jasmine, Mocha, and Cucumber. WebdriverIO provides a rich set of features for writing and managing end-to-end tests, including support for asynchronous operations and custom commands. Compared to jasminewd2, WebdriverIO offers more flexibility in terms of test framework integration and additional utilities.

nightwatch

Nightwatch.js is an end-to-end testing framework built on top of Selenium WebDriver. It provides a simple syntax for writing tests and includes built-in support for running tests in parallel. Nightwatch.js also supports various test frameworks, including Mocha and Cucumber. Compared to jasminewd2, Nightwatch.js offers a more integrated solution with built-in test runner and assertion library.

README

The README file is missing

Changelog

0.0.8

• (5abc745) chore(jasmine): update MatchFactory to allow message as function

• (750898c) fix(expectation): expectations without promises no longer add to task queue

  Instead, expectations without promises in either expected or actual are unchanged from the original Jasmine implementation.

  See https://github.com/angular/protractor/issues/2894