ember-qunit-nice-errors

Because expected true, result false is not enough!

This addon aims to improve the testing experience by defining a nice message on those asserts that don't have one set by you.

Installation

As easy as ember install ember-qunit-nice-errors

Example

When you have a test with a failing assertion and no custom message, the default error doesn't say much. As you can see by the following example test and the default ouput below:

import { module, test } from 'qunit';

module('Unit | ok test');

test('it works', function(assert) {
  assert.ok(1===3);
});

But with ember-qunit-nice-errors the message is way nicer!

Configuration

showFileInfo

If you want your error messages to include the original test file, line and column where the failed assertion is, just add the following configuration on your config/environment.js file:

ENV['ember-qunit-nice-errors'] = {
  showFileInfo: true
};

Before

assert.ok(false)

After

assert.ok(false) at my-app/tests/unit/ok-test.js:17:2

Also note you can enable this only for certain environments:

if (environment === 'development') {
  ENV['ember-qunit-nice-errors'] = {
    showFileInfo: true
  };
}

completeExistingMessages

If you fully trust us you can add this option to replace all assertions within your project tests, just add this to your configuration on your config/environment.js file:

ENV['ember-qunit-nice-errors'] = {
  completeExistingMessages: true
};

Don't worry, the override will still show your orginal messages, it is not a destructive operation!

The following example ilustrates what is the result of using the option completeExistingMessages.

Before

assert.ok(1 === 1, 'one should be one');

After

assert.ok(1 === 1, "assert.ok(1 === 1, 'one should be one')");

Supported assertions

We are currently supporting all the assertions provided by QUnit, those are:

• ok
• notOk
• equal
• notEqual
• deepEqual
• notDeepEqual
• propEqual
• notPropEqual
• strictEqual
• notStrictEqual

Maintainers

• Diego Acosta (@acostami)
• Federico Kauffman (@fedekau)
• Samanta de Barros (@sdebarros)
• Santiago Ferreira (@san650)

Credits

We got inspiration from

• qunit-helpful
• ember-watson

License

ember-qunit-nice-errors is licensed under the MIT license.

See LICENSE for the full license text.