react-test-helpers v1.0.0

react-test-helpers

Some handy helper functions for testing React components

Installation

You'll need both React and react-test-helpers:

npm install --save react && npm install --save-dev react-test-helpers

NOTE: if you want to use this in a non-browser environment you'll also need jsdom or similar (see src/__tests__/setup.js for how).

Usage

Example using Mocha and Chai should:

import React from 'react/addons';
import TestHelpers from 'react-test-helpers';

const {TestUtils} = React.addons;

describe('Testing a component', function () {
  it('renders something', function (done) {
    let MyComp = TestHelpers.createEmittingComponent({
      displayName: 'MyComp',
      render() {
        return <div>Hello world!</div>;
      }
    });

    let instance;

    MyComp.once('render', function () {
      const div = TestUtils.findRenderedDOMComponentWithTag(instance, 'div');
      div.getDOMNode().textContent.should.equal('Hello world!');
      done();
    });

    instance = TestHelpers.renderComponent(<MyComp />);
  })
});

API

renderComponent(component)

Renders a React component into an empty <div>. Automatically stores all rendered components for easy unmounting using unmountComponents below.

unmountComponents()

Unmounts all React components that have been rendered using the renderComponent function.

createEmittingComponent(spec)

Creates a React component with an event emitter which emits a "render" event when the component is rendered.

License

MIT