---
id: app/component-testing/react/api
title: React API
description: API for mounting React components in Cypress tests.
section: app
source_path: docs/app/component-testing/react/api.mdx
version: 24a73f8a97175663aaffd3b016289fb2a523a4ea
updated_at: '2026-05-14T20:17:33.301Z'
---
# React API

## Methods

### mount

```
import { mount } from 'cypress/react'
```

<table><tbody><tr><td>Description</td><td>Mounts a React component into the DOM.</td></tr><tr><td>Signature</td><td><p>mount(jsx: React.ReactNode, options?: MountOptions, rerenderKey?: string): Cypress.Chainable&lt;MountReturn&gt;</p></td></tr><tr><td>Returns</td><td>Cypress.Chainable&lt;MountReturn&gt;</td></tr></tbody></table>

<table><caption>mount Parameters</caption><thead></thead><tbody><tr><td>Name</td><td>Type</td><td>Description</td></tr><tr><td>jsx</td><td>React.JSX.Element</td><td>The React component to mount.</td></tr><tr><td>options</td><td>MountOptions (optional)</td><td>The options for mounting the component</td></tr><tr><td>rerenderKey</td><td>string (optional)</td><td>A key to use to force a rerender.</td></tr></tbody></table>

#### Example

```
import { mount } from '@cypress/react'import { Stepper } from './Stepper'it('mounts', () => {  mount(<StepperComponent />)  cy.get('[data-cy=increment]').click()  cy.get('[data-cy=counter]').should('have.text', '1')}
```

### getContainerEl

<table><tbody><tr><td>Description</td><td>Gets the root element used to mount the component.</td></tr><tr><td>Signature</td><td>() =&gt; HTMLElement</td></tr><tr><td>Returns</td><td>HTMLElement</td></tr></tbody></table>

## Interfaces

### MountOptions

<table><caption>members</caption><thead></thead><tbody><tr><td>Name</td><td>Type</td><td>Description</td></tr><tr><td>alias</td><td>string (optional)</td><td></td></tr><tr><td>ReactDom</td><td>MountReactComponentOptions.ReactDom (optional)</td><td></td></tr><tr><td>log</td><td>boolean (optional)</td><td>Log the mounting command into Cypress Command Log, true by default</td></tr><tr><td>strict</td><td>boolean (optional)</td><td><p>Render component in React <a href="https://reactjs.org/docs/strict-mode.html">strict mode</a> It activates additional checks and warnings for child components.</p></td></tr></tbody></table>

### MountReturn

Type that the `mount` function yields

<table><caption>members</caption><thead></thead><tbody><tr><td>Name</td><td>Type</td><td>Description</td></tr><tr><td>component</td><td>React.ReactNode</td><td><p>Render component in React <a href="https://reactjs.org/docs/strict-mode.html">strict mode</a> It activates additional checks and warnings for child components.</p></td></tr><tr><td>rerender</td><td><p>(component: React.ReactNode) =&gt; globalThis.Cypress.Chainable&lt;MountReturn&gt;</p></td><td>The component that was rendered.</td></tr></tbody></table>