Nearest Phase Modulator

    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/ember-test-helpers package

    0.6.3 • Public • Published

    ember-test-helpers Build Status

    A test-framework-agnostic set of helpers for testing Ember.js applications.


    This library is best used in conjunction with a test-framework-specific wrapper, such as ember-qunit or ember-mocha.

    This library was written using ES6 modules, which are contained in lib/. These modules must be transpiled for pre-ES6 compatibility.

    Test Helpers


    The TestModule class is used to configure modules for unit testing different aspects of your Ember application. This class can be extended to create modules focused on particular types of unit tests.

    TestModule is intended to be used in conjunction with modules specific to a test framework. For instance, you could create QUnit-compatible modules with a method such as:

    function moduleFor(name, description, callbacks) {
      var module = new TestModule(name, description, callbacks);
      QUnit.module(, {
        beforeEach() {
        afterEach() {

    TestModule(name [, description [, callbacks]])

    • name - the full name of the test subject as it is registered in a container (e.g. 'controller:application', 'route:index', etc.).

    • description (optional) - the description of the test module as it should be displayed in test output. If omitted, defaults to name.

    • callbacks (optional) - an object that may include setup and teardown steps as well as the other units needed by tests.


    TestModuleForComponent extends TestModule to allow unit testing of Ember Components.

    TestModuleForComponent(name [, description [, callbacks]])

    • name - the short name of the component that you'd use in a template (e.g. 'x-foo', 'color-picker', etc.).


    TestModuleForModel extends TestModule to allow unit testing of Ember Data Models.

    TestModuleForModel(name [, description [, callbacks]])

    • name - the short name of the model that you'd use in store operations (e.g. 'user', 'assignmentGroup', etc.).

    Miscellaneous Helpers

    • getContext / setContext - access the context to be used in each test.

    • setResolver - sets the resolver which will be used to look up objects from each test's container.

    • isolatedContainer - creates a new isolated container for unit testing.


    Contributions are welcome. Please follow the instructions below to install and test this library.


    $ npm install
    $ bower install


    In order to test in the browser:

    $ npm start

    ... and then visit http://localhost:4200/tests.

    In order to perform a CI test:

    $ npm test


    Much of ember-test-helpers was extracted from the original ember-qunit, which was written by Stefan Penner, Robert Jackson, and Ryan Florence.

    Copyright and License

    Copyright 2015 Switchfly and contributors.

    Dual-licensed under the Apache License, Version 2.0 and the MIT License.



    npm i ember-test-helpers

    DownloadsWeekly Downloads





    (MIT OR Apache-2.0)

    Last publish


    • ef4
    • rwjblue
    • stefanpenner
    • chadhietala
    • chancancode
    • dgeb
    • krisselden
    • locks
    • mmun
    • tomdale
    • wycats
    • katiegengler
    • nullvoxpopuli
    • scalvert
    • mixonic
    • turbo87
    • ember-cli