Course contentsShow
← React
Lesson 2043 of 2,39646. Testing React with RTLFree lesson

The render Function from RTL

Understanding how render mounts a component into a virtual DOM for testing and what it returns.

The render Function from RTL

What you'll learn: How RTL's render() mounts your component into a virtual testing environment and what tools it gives you back.

What render Does

The render function is your starting point for every RTL test. When you call it with a component, RTL creates a lightweight, virtual DOM (using jsdom) and mounts your component into it—just like React would in a real browser. This gives you an isolated, controlled environment to test user interactions without opening an actual browser.

Think of render as setting up a tiny stage where your component performs, complete with all its behaviors, but invisible and lightning-fast.

What render Returns

render doesn't just mount your component and leave you hanging. It returns an object packed with query functions to find elements:

import { render } from '@testing-library/react';
import { MyButton } from './MyButton';

const result = render(<MyButton label="Click me" />);

That result object contains:

  • Query functions like getByText, queryByRole, findByLabelText—tools to locate elements the way users would
  • container: the actual DOM node holding your component
  • debug(): a helper to print the current DOM state for debugging

Most commonly, you'll destructure just the queries you need:

const { getByText, getByRole } = render(<MyButton label="Click me" />);

Now you can find elements and test interactions without touching internal component details.

Why This Matters

render establishes the foundation for user-centric testing. It gives you the rendered output and accessibility-focused tools to query it—steering you away from implementation details and toward testing what users actually see and do.

Key Takeaway: render() mounts your component into a virtual DOM and returns query functions that mimic how users find elements, setting the stage for realistic, accessible testing.