ralphs-little-helpers

This README outlines the details of collaborating on this Ember addon.

Usage

First, install the addon:

$ ember install ralphs-little-helpers

Then, import the helpers you need:

// tests/helpers/start-app.js
 
import './ralphs-little-helpers/test-helpers';
// ...

// tests/acceptance/your-test.js
import { clickOn, findRole } from 'ralphs-little-helpers';
 
test('it works', assert => {
  clickOn('Foo!');
 
  andThen(() => {
    assert.notInclude(findRole('foo').text(), 'bar', 'foo is not bar');
  });
});

To use the matchers, import them in your test helper:

// tests/test-helper.js
import 'ralphs-little-helpers/extend-qunit';

Helpers

Imported

• clickOn(text) - Clicks on elements containing the text
• clickRole(role) - Clicks on elements with a matching [data-role]
• findRole(role) - Finds (with assert) an element with matching [data-role]
• fillInField(name, value) - Fills in a field with a [name] with the given value

Global

• check(selector, context) - Ensure an input[type="checkbox"] is checked
• uncheck(selector, context) - Ensure an input[type="checkbox"] is unchecked
• within(scope, block) - Scopes subsequent calls to test helpers by the provided selector.

QUnit Matchers

• assert.include(needle, haystack) - Asserts that the needle string is included in the haystack string
• assert.notInclude(needle, haystack) - Asserts that the needle string is included in the haystack string
• assert.textEqual(expected, actual) - Asserts that the expected string or node's text equals the actual string
• assert.hasClass(expected, actual) - Asserts that the expected node or selector has the actual class
• assert.checked(expected, message) - Asserts that the expected node or selector is :checked
• assert.unchecked(expected, message) - Asserts that the expected node or selector is not :checked

Installation

• git clone this repository
• npm install
• bower install

Running

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

Running Tests

• ember test
• ember test --server

Building

• ember build

For more information on using ember-cli, visit http://www.ember-cli.com/.

Contributing

See the CONTRIBUTING document. Thank you, contributors!

License

ralphs-little-helpers is Copyright (c) 2015 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the LICENSE file.

About

ralphs-little-helpers is maintained by Sean Doyle.

ralphs-little-helpers is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We love open source software! See our other projects or hire us to help build your product.