npmpackage.info

Gathering detailed insights and metrics for @testing-library/react-native

Other packages similar to @testing-library/react-native

@testing-library/jest-native

5.4.3

Custom jest matchers to test the state of React Native

react-native-testing-library

6.0.0

Simple React Native testing utilities helping you write better tests with less effort

@eps1lon/testing-library-react-native

11.4.0-alpha.2

Simple and complete React Native testing utilities that encourage good testing practices.

react-native-testing-mocks

1.7.0

React Native mocks for testing. Same as the internal Jest-based mocks, but decoupled of Jest dependency

Gathering detailed insights and metrics for @testing-library/react-native

@testing-library/react-native - 13.2.0 | npmpackage.info

@testing-library/react-native

🦉 Simple and complete React Native testing utilities that encourage good testing practices.

13.2.0

3,222

MIT

TypeScript

38.03 kB

95,902,858 3.8

Installations

npm install @testing-library/react-native

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=18

Node Version

20.12.0

NPM Version

10.5.0 Pull Requests

Open

8

Total

1,224

Closed

281

Merged

935

Issues

Open

7

Total

515

Closed

508

Releases

106

v14.0.0-alpha.1

Updated on Mar 10, 2025

v13.2.0

Updated on Mar 05, 2025

v13.1.1

Updated on Mar 05, 2025

v13.1.0

Updated on Feb 27, 2025

v13.0.1

Updated on Jan 14, 2025

v13.0.0

Updated on Jan 03, 2025

View All 106 releases

Languages

TypeScript

MDX

JavaScript

CSS

TypeScript (65.5%)

MDX (31.95%)

JavaScript (1.82%)

CSS (0.74%)

Developer

callstack

Download Statistics

Total Downloads

95,902,858

Last Day

29,055

Last Week

793,562

Last Month

3,501,597

Last Year

39,718,152

GitHub Statistics

MIT License

3,222 Stars

1,109 Commits

276 Forks

29 Watchers

13 Branches

158 Contributors

Updated on Jul 02, 2025

Bundle Size

133.14 kB

Minified

38.03 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 158 Contributors

Package Meta Information

Latest Version

13.2.0

Package Id

@testing-library/react-native@13.2.0

Unpacked Size

650.30 kB

Size

141.00 kB

File Count

308

NPM Version

10.5.0

Node Version

20.12.0

Published on

Mar 05, 2025

Total Downloads

Cumulative downloads

Total Downloads

95,902,858

Last Day

-9.1%

29,055

Compared to previous day

Last Week

-9.3%

793,562

Compared to previous week

Last Month

1.9%

3,501,597

Compared to previous month

Last Year

49.2%

39,718,152

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

React Native Testing Library

Developer-friendly and complete React Native testing utilities that encourage good testing practices.

The problem

You want to write maintainable tests for your React Native components. As a part of this goal, you want your tests to avoid including implementation details of your components and rather focus on making your tests give you the confidence for which they are intended. As part of this, you want your tests to be maintainable in the long run so refactors of your components (changes to implementation but not functionality) don't break your tests and slow you and your team down.

This solution

The React Native Testing Library (RNTL) is a comprehensive solution for testing React Native components. It provides React Native runtime simulation on top of react-test-renderer, in a way that encourages better testing practices. Its primary guiding principle is:

The more your tests resemble the way your software is used, the more confidence they can give you.

This project is inspired by React Testing Library. Tested to work with Jest, but it should work with other test runners as well.

Installation

Open a Terminal in your project's folder and run:

1# Yarn install:
2yarn add --dev @testing-library/react-native
3
4# NPM install
5npm install --save-dev @testing-library/react-native

This library has a peerDependencies listing for react-test-renderer. Make sure that your react-test-renderer version matches exactly the react version, avoid using ^ in version number.

Additional Jest matchers

You can use the built-in Jest matchers automatically by having any import from @testing-library/react-native in your test.

Example

1import { render, screen, userEvent } from '@testing-library/react-native';
2import { QuestionsBoard } from '../QuestionsBoard';
3
4// It is recommended to use userEvent with fake timers
5// Some events involve duration so your tests may take a long time to run.
6jest.useFakeTimers();
7
8test('form submits two answers', async () => {
9  const questions = ['q1', 'q2'];
10  const onSubmit = jest.fn();
11
12  const user = userEvent.setup();
13  render(<QuestionsBoard questions={questions} onSubmit={onSubmit} />);
14
15  const answerInputs = screen.getAllByLabelText('answer input');
16
17  // simulates the user focusing on TextInput and typing text one char at a time
18  await user.type(answerInputs[0], 'a1');
19  await user.type(answerInputs[1], 'a2');
20
21  // simulates the user pressing on any pressable element
22  await user.press(screen.getByRole('button', { name: 'Submit' }));
23
24  expect(onSubmit).toHaveBeenCalledWith({
25    1: { q: 'q1', a: 'a1' },
26    2: { q: 'q2', a: 'a2' },
27  });
28});

You can find the source of QuestionsBoard component and this example here.

API / Usage

React Native Testing Library consists of following APIs:

render function - render your UI components for testing purposes
screen object - access rendered UI:
- Queries - find rendered components by various predicates: role, text, test ids, etc
- Lifecycle methods: rerender, unmount
- Helpers: debug, toJSON, root
Jest matchers - validate assumptions about your UI
User Event - simulate common user interactions like press or type in a realistic way
Fire Event - simulate any component event in a simplified way
renderHook function - render hooks for testing purposes
Miscellaneous APIs:
- Async utils: findBy* queries, waitFor, waitForElementToBeRemoved
- Configuration: configure, resetToDefaults
- Accessibility: isHiddenFromAccessibility
- Other: within, act, cleanup

Migration Guides

Troubleshooting

Troubleshooting guide

Community Resources

Check out our list of Community Resources about RNTL.

Made with ❤️ at Callstack

React Native Testing Library is an open source project and will always remain free to use. If you think it's cool, please star it 🌟. Callstack is a group of React and React Native geeks, contact us at hello@callstack.com if you need any help with these or just want to say hi!

Like the project? ⚛️ Join the team who does amazing stuff for clients and drives React Native Open Source! 🔥

Supported and used by Rally Health.

No vulnerabilities found.

10

Maintained

Determines if the project is "actively maintained".

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

License

Determines if the project has defined a license.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/ci.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/ci.yml:66: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/ci.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/example-apps.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/example-apps.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/example-apps.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/example-apps.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/website.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/website.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/website.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/website.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/website.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/callstack/react-native-testing-library/website.yml/main?enable=pin
Info: 0 out of 9 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 2 third-party GitHubAction dependencies pinned

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.8

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @testing-library/react-native

Other packages similar to @testing-library/react-native

@testing-library/react-native

Installations

Developer Guide

Yes

CommonJS

>=18

20.12.0

10.5.0

Pull Requests

8

1,224

281

935

Issues

7

515

508

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Bundle Size

133.14 kB

38.03 kB

Maintainers

Package Meta Information

Total Downloads

95,902,858

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

React Native Testing Library

The problem

This solution

Installation

Additional Jest matchers

Example

API / Usage

Migration Guides

Troubleshooting

Community Resources

Made with ❤️ at Callstack

10

10

10

10

0

0

0

0

0

0

0

0

3.8

/10