ember-test-selectors-helpers

Overrides the default Ember.Test.find helper in order to make querying ember-test-selectors' data-test-* attributes as straightforward as possible.

Background

Previously, that addon shipped with a testSelector test helper that expanded a given string to make querying these attributes more straightforward, but it was recently deprecated and will be removed in an upcoming version.

Here's what that used to look like:

Given the following Handlebars template:

1<div data-test-my-div>My Div</div>

Here's how you might have used the testSelector helper in an acceptance test:

1import testSelector from 'ember-test-selectors';
2
3...
4
5test('an element is present', function(assert) {
6  assert.ok(findWithAssert(testSelector('my-div')), 'My div is present');
7});
8

With this addon, there's no need for the ceremony. It's as if Ember.js shipped with support for using data-test-* attributes out of the box:

1test('an element is present', function(assert) {
2  assert.ok(findWithAssert('my-div'), 'My div is present');
3});
4

The string my-div will automatically be expanded to the proper selector, assuming it is a hyphenated string. Otherwise, it will behave as the default find helper does.

Installation

You can install this addon by running

$ ember install ember-test-selectors-helpers

Afterwards, you'll need to import the test selectors before the startApp() helper is run:

1import overrideHelpers from './helper-overrides';
2
3overrideHelpers();
4
5// startApp()

Running

• ember serve
• Visit your app at http://localhost:4200.

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/.