mammoth-test-helpers

A set of QUnit extensions, stubs for common global tools, and other testing tools for testing Ember CLI applications.

Installation

• ember install mammoth-test-helpers

Use

The primary way to use this is to add some code to your tests/test-helper.js. You include the primary prepTests helper, and can programatically add additional helpers to load.

For example:

import resolver                  from './helpers/resolver';
import prepTests, { addToQueue } from 'mammoth-test-helpers/test-support/prep-tests';
import linkTo                    from 'mammoth-test-helpers/test-support/helpers/link-to-helper';
import googleChart               from 'mammoth-test-helpers/test-support/stubs/google-chart';
import stripe                    from 'mammoth-test-helpers/test-support/stubs/stripe';
import wysihtml5                 from 'mammoth-test-helpers/test-support/stubs/wysihtml5';
import { setResolver }           from '@ember/test-helpers';

setResolver(resolver);

// Add some non-default helpers
addToQueue(linkTo);
addToQueue(googleChart);
addToQueue(stripe);
addToQueue(wysihtml5);

// Load queued helpers
prepTests();

(This example loads everything!)

Modules

Several modules are includes:

|Path|Default?|Description|Source| |---|---|---|---| |mammoth-test-helpers/test-support/helpers/assert-helpers| Yes | Adds numerous helpers to QUnit's assert. |source| |mammoth-test-helpers/test-support/helpers/link-to-helper| | Adds data attributes to link-to helpers that track the passed in models / path. |source| |mammoth-test-helpers/test-support/helpers/ajax| | A couple of simple helpers for simplifying ajax requests (e.g. using Pretender.js). |source| |mammoth-test-helpers/test-support/helpers/jquery-actions| | Wrappers around ember-test-helper tools so that you can pass jQuery selectors |source| |mammoth-test-helpers/test-support/helpers/select-a-select| | A simple helper for firing a change action on a select. |source| |mammoth-test-helpers/test-support/shims/console| | Shim for window.console.log if it doesn't exist (thanks IE!). |source| |mammoth-test-helpers/test-support/stubs/google-chart| | Stub out common methods related to google charts. |source| |mammoth-test-helpers/test-support/stubs/stripe| | Stub out some common behavior for Stripe. |source| |mammoth-test-helpers/test-support/stubs/ember-tooltips| | Stub out components from ember-tooltips for unit tests. |source| |mammoth-test-helpers/test-support/stubs/wysihtml5| | Stub out globals for WysiHTML5. |source| |mammoth-test-helpers/test-support/temporary-stubs/rsvp| | Returns stubRSVP and unstubRSVP for situations where you don't want RSVP to throw an error (e.g. if you are testing failed requests). |source| |mammoth-test-helpers/test-support/temporary-stubs/window-actions| | Includes several methods for stubbing / unstubbing common blocking window actions (e.g. alert and confirm.) Stubs accept functions for testing parameters. |source|

Test Reporter

Included is a custom test reporter for Testem that results in simple output (dots) with failure summaries at the end. This is ideal in a CI environment.

To use, add this to your testem.js file:

const Reporter = require('./node_modules/mammoth-test-helpers/test-reporter');

module.exports = {
  reporter: Reporter,
...

Running Tests

• npm test (Runs ember try:each to test your addon against multiple Ember versions)
• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit https://ember-cli.com/.