{"componentChunkName":"component---src-templates-docs-js","path":"/docs/test-utils.html","result":{"data":{"markdownRemark":{"html":"

Importing

\n
import ReactTestUtils from 'react-dom/test-utils'; // ES6\nvar ReactTestUtils = require('react-dom/test-utils'); // ES5 with npm
\n

Overview

\n

ReactTestUtils makes it easy to test React components in the testing framework of your choice. At Facebook we use Jest for painless JavaScript testing. Learn how to get started with Jest through the Jest website’s React Tutorial.

\n
\n

Note:

\n

We recommend using React Testing Library which is designed to enable and encourage writing tests that use your components as the end users do.

\n

For React versions <= 16, the Enzyme library makes it easy to assert, manipulate, and traverse your React Components’ output.

\n
\n\n

Reference

\n

act()

\n

To prepare a component for assertions, wrap the code rendering it and performing updates inside an act() call. This makes your test run closer to how React works in the browser.

\n
\n

Note

\n

If you use react-test-renderer, it also provides an act export that behaves the same way.

\n
\n

For example, let’s say we have this Counter component:

\n
class Counter extends React.Component {\n  constructor(props) {\n    super(props);\n    this.state = {count: 0};\n    this.handleClick = this.handleClick.bind(this);\n  }\n  componentDidMount() {\n    document.title = `You clicked ${this.state.count} times`;\n  }\n  componentDidUpdate() {\n    document.title = `You clicked ${this.state.count} times`;\n  }\n  handleClick() {\n    this.setState(state => ({\n      count: state.count + 1,\n    }));\n  }\n  render() {\n    return (\n      <div>\n        <p>You clicked {this.state.count} times</p>\n        <button onClick={this.handleClick}>\n          Click me\n        </button>\n      </div>\n    );\n  }\n}
\n

Here is how we can test it:

\n
import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport { act } from 'react-dom/test-utils';import Counter from './Counter';\n\nlet container;\n\nbeforeEach(() => {\n  container = document.createElement('div');\n  document.body.appendChild(container);\n});\n\nafterEach(() => {\n  document.body.removeChild(container);\n  container = null;\n});\n\nit('can render and update a counter', () => {\n  // Test first render and componentDidMount\n  act(() => {    ReactDOM.createRoot(container).render(<Counter />);  });  const button = container.querySelector('button');\n  const label = container.querySelector('p');\n  expect(label.textContent).toBe('You clicked 0 times');\n  expect(document.title).toBe('You clicked 0 times');\n\n  // Test second render and componentDidUpdate\n  act(() => {    button.dispatchEvent(new MouseEvent('click', {bubbles: true}));  });  expect(label.textContent).toBe('You clicked 1 times');\n  expect(document.title).toBe('You clicked 1 times');\n});
\n\n
\n

mockComponent()

\n
mockComponent(\n  componentClass,\n  [mockTagName]\n)
\n

Pass a mocked component module to this method to augment it with useful methods that allow it to be used as a dummy React component. Instead of rendering as usual, the component will become a simple <div> (or other tag if mockTagName is provided) containing any provided children.

\n
\n

Note:

\n

mockComponent() is a legacy API. We recommend using jest.mock() instead.

\n
\n
\n

isElement()

\n
isElement(element)
\n

Returns true if element is any React element.

\n
\n

isElementOfType()

\n
isElementOfType(\n  element,\n  componentClass\n)
\n

Returns true if element is a React element whose type is of a React componentClass.

\n
\n

isDOMComponent()

\n
isDOMComponent(instance)
\n

Returns true if instance is a DOM component (such as a <div> or <span>).

\n
\n

isCompositeComponent()

\n
isCompositeComponent(instance)
\n

Returns true if instance is a user-defined component, such as a class or a function.

\n
\n

isCompositeComponentWithType()

\n
isCompositeComponentWithType(\n  instance,\n  componentClass\n)
\n

Returns true if instance is a component whose type is of a React componentClass.

\n
\n

findAllInRenderedTree()

\n
findAllInRenderedTree(\n  tree,\n  test\n)
\n

Traverse all components in tree and accumulate all components where test(component) is true. This is not that useful on its own, but it’s used as a primitive for other test utils.

\n
\n

scryRenderedDOMComponentsWithClass()

\n
scryRenderedDOMComponentsWithClass(\n  tree,\n  className\n)
\n

Finds all DOM elements of components in the rendered tree that are DOM components with the class name matching className.

\n
\n

findRenderedDOMComponentWithClass()

\n
findRenderedDOMComponentWithClass(\n  tree,\n  className\n)
\n

Like scryRenderedDOMComponentsWithClass() but expects there to be one result, and returns that one result, or throws exception if there is any other number of matches besides one.

\n
\n

scryRenderedDOMComponentsWithTag()

\n
scryRenderedDOMComponentsWithTag(\n  tree,\n  tagName\n)
\n

Finds all DOM elements of components in the rendered tree that are DOM components with the tag name matching tagName.

\n
\n

findRenderedDOMComponentWithTag()

\n
findRenderedDOMComponentWithTag(\n  tree,\n  tagName\n)
\n

Like scryRenderedDOMComponentsWithTag() but expects there to be one result, and returns that one result, or throws exception if there is any other number of matches besides one.

\n
\n

scryRenderedComponentsWithType()

\n
scryRenderedComponentsWithType(\n  tree,\n  componentClass\n)
\n

Finds all instances of components with type equal to componentClass.

\n
\n

findRenderedComponentWithType()

\n
findRenderedComponentWithType(\n  tree,\n  componentClass\n)
\n

Same as scryRenderedComponentsWithType() but expects there to be one result and returns that one result, or throws exception if there is any other number of matches besides one.

\n
\n

renderIntoDocument()

\n
renderIntoDocument(element)
\n

Render a React element into a detached DOM node in the document. This function requires a DOM. It is effectively equivalent to:

\n
const domContainer = document.createElement('div');\nReactDOM.createRoot(domContainer).render(element);
\n
\n

Note:

\n

You will need to have window, window.document and window.document.createElement globally available before you import React. Otherwise React will think it can’t access the DOM and methods like setState won’t work.

\n
\n
\n

Other Utilities

\n

Simulate

\n
Simulate.{eventName}(\n  element,\n  [eventData]\n)
\n

Simulate an event dispatch on a DOM node with optional eventData event data.

\n

Simulate has a method for every event that React understands.

\n

Clicking an element

\n
// <button ref={(node) => this.button = node}>...</button>\nconst node = this.button;\nReactTestUtils.Simulate.click(node);
\n

Changing the value of an input field and then pressing ENTER.

\n
// <input ref={(node) => this.textInput = node} />\nconst node = this.textInput;\nnode.value = 'giraffe';\nReactTestUtils.Simulate.change(node);\nReactTestUtils.Simulate.keyDown(node, {key: \"Enter\", keyCode: 13, which: 13});
\n
\n

Note

\n

You will have to provide any event property that you’re using in your component (e.g. keyCode, which, etc…) as React is not creating any of these for you.

\n
\n
","frontmatter":{"title":"Test Utilities","next":null,"prev":null},"fields":{"path":"content/docs/addons-test-utils.md","slug":"docs/test-utils.html"}}},"pageContext":{"slug":"docs/test-utils.html"}},"staticQueryHashes":[]}