/ember-test-helpers

Test-framework-agnostic helpers for testing Ember.js applications

Primary LanguageJavaScriptApache License 2.0Apache-2.0

ember-test-helpers Build Status

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

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.