no-container.md

Disallow the use of container methods (testing-library/no-container)

By using container methods like .querySelector you may lose a lot of the confidence that the user can really interact with your UI. Also, the test becomes harder to read, and it will break more frequently.

This applies to Testing Library frameworks built on top of DOM Testing Library

Rule Details

This rule aims to disallow the use of container methods in your tests.

Examples of incorrect code for this rule:

const { container } = render(<Example />);
const button = container.querySelector('.btn-primary');

const { container: alias } = render(<Example />);
const button = alias.querySelector('.btn-primary');

const view = render(<Example />);
const button = view.container.getElementsByClassName('.btn-primary');

Examples of correct code for this rule:

render(<Example />);
screen.getByRole('button', { name: /click me/i });

Further Reading

• about the container element
• querying with screen