thoughtbot's Ember Test Helpers
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
addon
app
bin
blueprints/ember-tb-test-helpers
config
test-support/helpers/ralphs-little-helpers
tests
vendor
.bowerrc
.editorconfig
.ember-cli
.gitignore
.hound.yml
.jshintrc
.npmignore
.travis.yml
.watchmanconfig
CHANGELOG.md
CONTRIBUTING.md
LICENSE.md
README.md
RELEASING.md
bower.json
ember-cli-build.js
index.js
package.json
testem.json

README.md

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

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.

thoughtbot

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.