JavaScript Shell
Switch branches/tags
v2.9.1 v2.9.0 v2.8.2 v2.8.1 v2.8.0 v2.7.1 v2.7.0 v2.6.0 v2.5.2 v2.5.1 v2.5.0 v2.4.2 v2.4.1 v2.4.0 v2.3.0 v2.2.0 v2.1.0 v2.0.0 v1.6.0 v1.5.0 v1.4.1 v1.4.0 v1.3.1 v1.3.0 v1.2.0 v1.1.0 v1.0.0 reagent-v1.0.1 reagent-v1.0.0 enzyme@3.4.3 enzyme@3.4.2 enzyme@3.4.1 enzyme@3.4.0 enzyme@3.3.0 enzyme@3.2.0 enzyme@3.1.1 enzyme@3.1.0 enzyme@3.0.0 enzyme@3.0.0-beta.7 enzyme@3.0.0-beta.6 enzyme@3.0.0-beta.5 enzyme@3.0.0-beta.4 enzyme@3.0.0-beta.3 enzyme@3.0.0-beta.2 enzyme@3.0.0-beta.1 enzyme-test-suite@1.0.0 enzyme-test-suite@1.0.0-beta.7 enzyme-test-suite@1.0.0-beta.6 enzyme-test-suite@1.0.0-beta.5 enzyme-test-suite@1.0.0-beta.4 enzyme-test-suite@1.0.0-beta.3 enzyme-test-suite@1.0.0-beta.2 enzyme-test-suite@1.0.0-beta.1 enzyme-adapter-utils@1.5.0 enzyme-adapter-utils@1.4.0 enzyme-adapter-utils@1.3.0 enzyme-adapter-utils@1.2.0 enzyme-adapter-utils@1.1.1 enzyme-adapter-utils@1.1.0 enzyme-adapter-utils@1.0.1 enzyme-adapter-utils@1.0.0 enzyme-adapter-utils@1.0.0-beta.7 enzyme-adapter-utils@1.0.0-beta.6 enzyme-adapter-utils@1.0.0-beta.5 enzyme-adapter-utils@1.0.0-beta.4 enzyme-adapter-utils@1.0.0-beta.3 enzyme-adapter-utils@1.0.0-beta.2 enzyme-adapter-utils@1.0.0-beta.1 enzyme-adapter-react-helper@1.3.0 enzyme-adapter-react-helper@1.2.3 enzyme-adapter-react-helper@1.2.2 enzyme-adapter-react-helper@1.2.1 enzyme-adapter-react-helper@1.2.0 enzyme-adapter-react-helper@1.1.0 enzyme-adapter-react-helper@1.0.3 enzyme-adapter-react-helper@1.0.2 enzyme-adapter-react-helper@1.0.1 enzyme-adapter-react-helper@1.0.0 enzyme-adapter-react-16.3@1.0.0 enzyme-adapter-react-16.2@1.0.0 enzyme-adapter-react-16@1.2.0 enzyme-adapter-react-16@1.1.1 enzyme-adapter-react-16.1@1.0.0 enzyme-adapter-react-16@1.1.0 enzyme-adapter-react-16@1.0.4 enzyme-adapter-react-16@1.0.3 enzyme-adapter-react-16@1.0.2 enzyme-adapter-react-16@1.0.1 enzyme-adapter-react-16@1.0.0 enzyme-adapter-react-16@1.0.0-beta.7 enzyme-adapter-react-16@1.0.0-beta.6 enzyme-adapter-react-16@1.0.0-beta.5 enzyme-adapter-react-16@1.0.0-beta.4 enzyme-adapter-react-16@1.0.0-beta.3 enzyme-adapter-react-16@1.0.0-beta.2 enzyme-adapter-react-16@1.0.0-beta.1 enzyme-adapter-react-15.4@1.0.6 enzyme-adapter-react-15.4@1.0.5 enzyme-adapter-react-15.4@1.0.4 enzyme-adapter-react-15.4@1.0.3
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.github Update issue templates May 2, 2018
docs [Docs] `shallow`/`mount`: SyntheticEvent and event properties note Aug 16, 2018
packages Merge tag 'enzyme@3.4.3' Aug 17, 2018
test Update tests Sep 13, 2017
.babelrc [*] [Dev Deps] update `babel-core`, `babel-plugin-transform-replace-o… Jul 7, 2018
.eslintignore [Dev Deps] update `eslint`, `eslint-config-airbnb`, `eslint-plugin-im… Aug 15, 2018
.eslintrc [Dev Deps] update `eslint`, `eslint-config-airbnb`, `eslint-plugin-im… Aug 15, 2018
.gitignore [meta] ensure a license and readme is present in all packages when pu… Aug 1, 2018
.lgtm [lgtm] Fix capitalization of maintainer name, drop approvals to 1 May 10, 2016
.npmignore Remove babelrc from npm package. (#311) Apr 18, 2016
.npmrc Only apps should have lockfiles. Jun 1, 2017
.travis.yml [Tests] add React v16.3 Aug 7, 2018 [enzyme] v3.4.3 Aug 17, 2018 [Docs] Clarify dev workflow in Oct 1, 2017 Add Cerner to INTHEWILD Jan 24, 2018 Refined docs a bit more Nov 16, 2015
MAINTAINERS [lgtm] Fix capitalization of maintainer name, drop approvals to 1 May 10, 2016 Documenting Enzyme configuration with Karma Aug 15, 2018 Documenting Enzyme configuration with Karma Aug 15, 2018
book.json Update to GitBook 3 Sep 11, 2017
env.js [Tests] fix env.js Jan 6, 2018 [enzyme-adapter-react-16.3] fork the react 16 adapter for ~16.3 Aug 7, 2018
karma.conf.js [enzyme-adapter-react-16.3] fork the react 16 adapter for ~16.3 Aug 7, 2018
lerna.json Move to lerna independent mode Sep 16, 2017
package.json [Dev Deps] update `eslint`, `eslint-config-airbnb`, `eslint-plugin-im… Aug 15, 2018


Join the chat at

npm Version License Build Status Coverage Status

Enzyme is a JavaScript Testing utility for React that makes it easier to assert, manipulate, and traverse your React Components' output.

Enzyme's API is meant to be intuitive and flexible by mimicking jQuery's API for DOM manipulation and traversal.

Upgrading from Enzyme 2.x or React < 16

Are you here to check whether or not Enzyme is compatible with React 16? Are you currently using Enzyme 2.x? Great! Check out our migration guide for help moving on to Enzyme v3 where React 16 is supported.


To get started with enzyme, you can simply install it via npm. You will need to install enzyme along with an Adapter corresponding to the version of react (or other UI Component library) you are using. For instance, if you are using enzyme with React 16, you can run:

npm i --save-dev enzyme enzyme-adapter-react-16

Each adapter may have additional peer dependencies which you will need to install as well. For instance, enzyme-adapter-react-16 has peer dependencies on react and react-dom.

At the moment, Enzyme has adapters that provide compatibility with React 16.x, React 15.x, React 0.14.x and React 0.13.x.

The following adapters are officially provided by enzyme, and have the following compatibility with React:

Enzyme Adapter Package React semver compatibility
enzyme-adapter-react-16 ^16.4.0-0
enzyme-adapter-react-16.3 ~16.3.0-0
enzyme-adapter-react-16.2 ~16.2
enzyme-adapter-react-16.1 ~16.0.0-0 || ~16.1
enzyme-adapter-react-15 ^15.5.0
enzyme-adapter-react-15.4 15.0.0-0 - 15.4.x
enzyme-adapter-react-14 ^0.14.0
enzyme-adapter-react-13 ^0.13.0

Finally, you need to configure enzyme to use the adapter you want it to use. To do this, you can use the top level configure(...) API.

import Enzyme from 'enzyme';
import Adapter from 'enzyme-adapter-react-16';

Enzyme.configure({ adapter: new Adapter() });

3rd Party Adapters

It is possible for the community to create additional (non-official) adapters that will make enzyme work with other libraries. If you have made one and it's not included in the list below, feel free to make a PR to this README and add a link to it! The known 3rd party adapters are:

Adapter Package For Library Status
preact-enzyme-adapter preact (work in progress)
enzyme-adapter-inferno inferno (work in progress)

Running Enzyme Tests

Enzyme is unopinionated regarding which test runner or assertion library you use, and should be compatible with all major test runners and assertion libraries out there. The documentation and examples for enzyme use mocha and chai, but you should be able to extrapolate to your framework of choice.

If you are interested in using enzyme with custom assertions and convenience functions for testing your React components, you can consider using:

Using Enzyme with Mocha

Using Enzyme with Karma

Using Enzyme with Browserify

Using Enzyme with SystemJS

Using Enzyme with Webpack

Using Enzyme with JSDOM

Using Enzyme with React Native

Using Enzyme with Jest

Using Enzyme with Lab

Using Enzyme with Tape and AVA

Basic Usage

Shallow Rendering

import React from 'react';
import { expect } from 'chai';
import { shallow } from 'enzyme';
import sinon from 'sinon';

import MyComponent from './MyComponent';
import Foo from './Foo';

describe('<MyComponent />', () => {
  it('renders three <Foo /> components', () => {
    const wrapper = shallow(<MyComponent />);

  it('renders an `.icon-star`', () => {
    const wrapper = shallow(<MyComponent />);

  it('renders children when passed in', () => {
    const wrapper = shallow((
        <div className="unique" />
    expect(wrapper.contains(<div className="unique" />)).to.equal(true);

  it('simulates click events', () => {
    const onButtonClick = sinon.spy();
    const wrapper = shallow(<Foo onButtonClick={onButtonClick} />);
    expect(onButtonClick)'callCount', 1);

Read the full API Documentation

Full DOM Rendering

import React from 'react';
import sinon from 'sinon';
import { expect } from 'chai';
import { mount } from 'enzyme';

import Foo from './Foo';

describe('<Foo />', () => {
  it('allows us to set props', () => {
    const wrapper = mount(<Foo bar="baz" />);
    wrapper.setProps({ bar: 'foo' });

  it('simulates click events', () => {
    const onButtonClick = sinon.spy();
    const wrapper = mount((
      <Foo onButtonClick={onButtonClick} />
    expect(onButtonClick)'callCount', 1);

  it('calls componentDidMount', () => {
    sinon.spy(Foo.prototype, 'componentDidMount');
    const wrapper = mount(<Foo />);
    expect(Foo.prototype.componentDidMount)'callCount', 1);

Read the full API Documentation

Static Rendered Markup

import React from 'react';
import { expect } from 'chai';
import { render } from 'enzyme';

import Foo from './Foo';

describe('<Foo />', () => {
  it('renders three `.foo-bar`s', () => {
    const wrapper = render(<Foo />);

  it('renders the title', () => {
    const wrapper = render(<Foo title="unique" />);

Read the full API Documentation


Enzyme Future


See the Contributors Guide

In the wild

Organizations and projects using enzyme can list themselves here.