Testing Library logo

Testing Library

Open Source

Family of testing utilities for DOM, React, Vue, Angular focused on user behaviour over implementation details.

Visit websiteGitHub

Pricing

Free / Open source

Type

Automation

Languages

JavaScript, TypeScript

// VERDICT

Reach for Testing Library when you want component/unit tests that mirror user behaviour and resist refactors by avoiding implementation details. Skip it when you want a component workshop (Storybook), pure E2E, or to assert on internals.

Best for

A family of libraries for testing UI components the way users interact with them - querying by role/text rather than implementation details, encouraging accessible, resilient component tests.

Avoid when

You want a component workshop (Storybook), end-to-end only, or testing of implementation internals.

CI/CD fit

Runs with Jest/Vitest · jsdom or real browser · CI unit/component tests

Languages

JavaScript · TypeScript

Team fit

Frontend teams · React/Vue/Angular/etc. · QA writing resilient component tests

Setup

Easy

Maintenance

Low

Learning

Beginner

Licence

Free / Open source

// BEST FOR

  • Testing components the way users interact with them
  • Querying by role/text (accessible-by-default)
  • Resisting refactors by avoiding implementation details
  • Bindings for React, Vue, Angular, Svelte and more
  • Fast component/unit tests with Jest/Vitest
  • Encouraging accessibility through role queries

// AVOID WHEN

  • You want a component workshop/documentation (Storybook)
  • You need end-to-end testing only
  • You want to assert on implementation internals
  • A non-component UI is under test
  • You want visual regression (use a visual tool)
  • Full browser E2E is the goal (Playwright/Cypress)

// QUICK START

npm install -D @testing-library/react @testing-library/jest-dom
// render(<C/>); screen.getByRole('button'); userEvent.click(...); expect(...).toBeVisible()

// ALTERNATIVES TO CONSIDER

ToolChoose it when
StorybookYou want to develop/test components in an isolated workshop.
TestCafeYou want broader end-to-end browser testing.
PlaywrightYou want full browser E2E (and component testing).

// FEATURES

  • Queries that mirror how users find elements (role, label, text)
  • Implementations for React, Vue, Angular, Svelte, and Cypress
  • Encourages accessible markup as a side effect of test queries
  • Async utilities (findBy, waitFor) for testing dynamic UIs
  • user-event library for realistic interaction simulation

// PROS

  • Tests survive refactors — bound to user-visible behaviour, not internals
  • Promotes accessibility through role- and label-based queries
  • Default in Create React App, Next.js, and Vue templates
  • Tiny API surface — fast to learn

// CONS

  • Needs a runner (Jest/Vitest) — not standalone
  • Async query patterns trip up newcomers
  • Doesn't cover real-browser tests — still need Playwright/Cypress for those

// EXAMPLE QA WORKFLOW

  1. Add the Testing Library binding + runner

  2. Write tests querying by role/text

  3. Simulate user events

  4. Assert on user-visible behaviour

  5. Run with Jest/Vitest in CI

  6. Keep queries user-centric and resilient

// RELATED QA.CODES RESOURCES

Glossary