ember-test-helpers

ember-test-helpers

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

Usage

This library is best used by way of a test-framework-specific wrapper, such as ember-qunit or ember-mocha.

Test Helpers

The exports of this library are intended to be utility functions that can be used to bring the standard Ember testing experience to any testing framework.

A quick summary of the exports from the ember-test-helpers module:

• setResolver - This function is used to allow the other functions build a valid container/registry that is able to look objects up from your application (just as a running Ember application would).
• setContext - Invoked by the host testing framework to set the current testing context (generally the this within a running test).
• getContext - Used to retrieve the current testing context.
• unsetContext - Used to ensure that all handles on the testing context are released (allowing GC).
• setupContext - Sets up a given testing context with owner, get, set, etc properties.
• teardownContext - Cleans up any objects created as part of the owner created in setupContext.
• setupRenderingContext - Sets up the provided context with the ability to render template snippets by adding render, clearRender, etc.
• teardownRenderingContext - Cleans up any work done in a rendering test.
• settled - Returns a promise which will resolve when all async from AJAX, test waiters, and scheduled timers have completed.

Collaborating

Installation

• git clone <repository-url> this repository
• cd ember-test-helpers
• npm install

Running

• ember serve
• Visit your app at http://localhost:4200.

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/.

Attribution

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.

Changelog

v0.7.0-beta.6 (2017-10-17)

Full Changelog

Implemented enhancements:

• Expose settled helper function. #223 (rwjblue)
• Expose importable helper functions. #222 (rwjblue)

Merged pull requests:

• Update README for new API iteration. #225 (rwjblue)
• Continue to flesh out more tests for new API's. #224 (rwjblue)
• Move setContext into setupContext. #221 (rwjblue)