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 repositorycd ember-test-helpers
npm install
Running
Running Tests
npm test
(Runs ember try:each
to test your addon against multiple Ember versions)ember test
ember test --server
Building
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.