ember-simple-auth-testing

Ember Simple Auth Testing

This is an extension to the Ember Simple Auth library that provides test helpers to authenticate and invalidate the session without having to stub server responses etc.

The Helpers

To authenticate the session, use the authenticateSession helper, e.g.:

test('a protected route is accessible when the session is authenticated', function() {
  expect(1);
  authenticateSession();
  visit('/protected');

  andThen(function() {
    equal(currentRouteName(), 'protected');
  });
});

and to invalidate the session, use the invaldiateSession helper, e.g.:

test('a protected route is not accessible when the session is not authenticated', function() {
  expect(1);
  invalidateSession();
  visit('/protected');

  andThen(function() {
    notEqual(currentRouteName(), 'protected');
  });
});

This package also defines the currentSession helper that provides access to the session from tests to e.g. set properties on it:

test("the current project's name is displayed in the page header", function() {
  expect(1);
  authenticateSession();
  currentSession().set('currentProject', 'some test project');
  visit('/dashboard');

  andThen(function() {
    findWithAssert('h1:contains("some test project")');
  });
});

Configuration

When using the testing helpers also make sure to use the ephemeral session store for the test environment as otherwise the session will be persisted and tests might influence each other.

//config/environment.js
if (environment === 'test') {
  ENV['simple-auth'].store = 'simple-auth-session-store:ephemeral';
}

Installation

To install Ember Simple Auth Testing in an Ember.js application there are several options:

• If you're using Ember CLI, just add the Ember CLI Addon to your project. Also import the test helpers in tests/helpers/start-app.js before the export:

  …
  import initializeTestHelpers from 'simple-auth-testing/test-helpers';
  initializeTestHelpers();
  
  export default function startApp(attrs) {
  …

  and add "authenticateSession" and "invalidateSession" to the "predef" section of tests/.jshintrc.

• The Ember Simple Auth testing extension library is also included in the "ember-simple-auth" bower package both in a browserified version as well as an AMD build. If you're using the AMD build from bower be sure to require the test helpers explicitly:

  require('simple-auth-testing/test-helpers');

  The browserified version will automatically register the test helpers once it is loaded in the application.

• Download a prebuilt version from the releases page