Ralphs-little-helpers NPM

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