Clicks an element and triggers any actions triggered by the element's click event.

Example:

click('.some-jQuery-selector').then(function() {
  // assert something
});

Returns the current path.

Example:

function validateURL(){
equal(currentPath(), 'some.path.index', "correct path was transitioned into.");
}

click('#some-link-id').then(validateURL);

Returns the currently active route name.

Example:

function validateRouteName(){
equal(currentRouteName(), 'some.path', "correct route was transitioned into.");
}

visit('/some/path').then(validateRouteName)

Returns the current URL.

Example:

function validateURL(){
equal(currentURL(), '/some/path', "correct URL was transitioned into.");
}

click('#some-link-id').then(validateURL);

Fills in an input element with some text.

Example:

fillIn('#email', 'you@example.com').then(function() {
  // assert something
});

Finds an element in the context of the app's container element. A simple alias for app.$(selector).

Example:

var $el = find('.my-selector');

Like find, but throws an error if the element selector returns no results.

Example:

var $el = findWithAssert('.doesnt-exist'); // throws error

This injects the test helpers into the helperContainer object. If an object is provided it will be used as the helperContainer. If helperContainer is not set it will default to window. If a function of the same name has already been defined it will be cached (so that it can be reset if the helper is removed with unregisterHelper or removeTestHelpers).

Any callbacks registered with onInjectHelpers will be called once the helpers have been injected.

Example:

App.injectTestHelpers();

Simulates a key event, e.g. keypress, keydown, keyup with the desired keyCode

Example:

keyEvent('.some-jQuery-selector', 'keypress', 13).then(function() {
 // assert something
});

Sets Ember up for testing. This is useful to perform basic setup steps in order to unit test.

Use App.setupForTesting to perform integration tests (full application testing).

This hook defers the readiness of the application, so that you can start the app when your tests are ready to run. It also sets the router's location to 'none', so that the window's location will not be modified (preventing both accidental leaking of state between tests and interference with your testing framework).

Example:

App.setupForTesting();

Triggers the given event on the element identified by the provided selector.

Example:

triggerEvent('#some-elem-id', 'blur');

This is actually used internally by the keyEvent helper like so:

triggerEvent('#some-elem-id', 'keypress', { keyCode: 13 });

Loads a route, sets up any controllers, and renders any templates associated with the route as though a real user had triggered the route change while using your app.

Example:

visit('posts/index').then(function() {
  // assert something
});

Causes the run loop to process any pending events. This is used to ensure that any async operations from other helpers (or your assertions) have been processed.

This is most often used as the return value for the helper functions (see 'click', 'fillIn','visit',etc).

Example:

Ember.Test.registerAsyncHelper('loginUser', function(app, username, password) {
  visit('secured/path/here')
  .fillIn('#username', username)
  .fillIn('#password', username)
  .click('.submit')

  return wait();
});