callstack/react-native-testing-library
React Native Testing Library
This project is a testing framework designed for React Native applications, providing a suite of tools to render components in a controlled memory environment. It enables developers to verify the behavior and structure of mobile interfaces by simulating user interactions and monitoring component lifecycle transitions. By isolating components from the rest of the application, it ensures that tests remain stable and independent.
The framework distinguishes itself through an accessibility-first approach, prioritizing user-facing attributes like roles, labels, and text content when querying the component tree. This methodology ensures that tests reflect how a real user perceives and interacts with the interface, rather than relying on internal implementation details. It also includes robust support for asynchronous operations, automatically synchronizing assertions with background state updates and delayed UI rendering to prevent race conditions.
Beyond core rendering and interaction, the library provides comprehensive capabilities for validating UI state, inspecting component styles, and verifying accessibility properties. It supports testing custom hooks in isolation, managing complex component trees through provider injection, and performing structural verification via snapshots. These features allow for thorough quality assurance across various mobile interface scenarios.
Features
- Component and Interaction Testing - Mounts components into a virtual environment to enable interaction and verification during testing.
- React Native Testing Frameworks - Provides a specialized framework for testing mobile components by simulating user interactions and verifying rendered output through accessible, user-centric queries.
- Scene Element Queries by Criteria - Enables retrieval of specific interface components using criteria like roles, labels, or text.
- Asynchronous UI Test Verifications - Synchronizes test assertions with background state updates to verify application behavior in asynchronous scenarios.
- User Interaction Simulation - Simulates user inputs like presses and gestures to verify application responsiveness to real-world behavior.
- Component Content Validation - Check that interface elements display the correct text or accessible names to ensure that the information presented to the user matches the intended design.
- Component Rendering Utilities - Provides utilities for mounting and rendering components in a controlled environment to facilitate testing.
- Auto-Waiting Assertions - Pauses test execution while repeatedly checking conditions to ensure assertions account for delayed state changes.
- Element State Assertions - Provides specialized matchers to verify element properties and accessibility status during UI state validation.
- Asynchronous Test Handling - Synchronizes test assertions with asynchronous UI updates and state transitions.
- React Component Testing - Implements a testing environment for mounting and verifying React-based mobile UI components in isolation.
- Visual Assertion Validators - Asserts expectations about rendered output, including visibility and accessibility status, using specialized matchers.
- Accessibility Query Engines - Provides an accessibility-first query engine to locate interface elements by roles and labels.
- Asynchronous Element Waiting - Queries the component tree repeatedly until elements appear, synchronizing tests with asynchronous UI updates.
- Test-Controlled State Updates - Forces state updates and asynchronous effects to complete before assertions run to prevent race conditions.
- Rendered Tree Querying - Locates specific components in the rendered tree using attributes for state verification.
- Component Snapshots - Generates JSON snapshots of component trees to facilitate structural verification.
- User Action Intents - Locates components using user-centric intent criteria like roles and labels.
- Component Tree Traversers - Navigates rendered component hierarchies to locate elements based on accessibility and structural properties.
- Component Re-renderers - Supports re-rendering components with new properties to process asynchronous updates during testing.
- Snapshot Verification Tools - Serializes rendered component trees into persistent snapshots to track and validate UI structure over time.
- Test Isolation - Ensures test stability by mounting components into isolated, controlled memory environments.
- Asynchronous Polling Mechanisms - Implements asynchronous polling mechanisms to synchronize test assertions with background UI updates.
- Mobile Accessibility Auditing - Provides utilities for verifying that mobile interface elements correctly communicate their status and labels to assistive technologies.
- Accessibility Testing Tools - Provides a testing environment that prioritizes user-facing roles and labels to ensure mobile interfaces are perceivable by assistive technologies.
- Component Testing - Provides a library for verifying the behavior and structure of UI components through isolated testing and lifecycle management.
- Text Rendering Stress Tests - Enforces runtime constraints by validating that text strings are correctly placed within designated containers.
- Mobile Testing Frameworks - Offers a comprehensive testing environment for mobile applications that supports component rendering, state validation, and asynchronous event simulation.
- Component Lifecycle Hooks - Wraps components in lifecycle hooks to monitor state transitions and side effects during testing.
- Accessibility State Synchronization - Validates that interface elements correctly communicate their accessibility states to assistive technologies.
- Custom Hook Testing - Enables testing of hook logic in isolation to verify state transitions and side effects without a full component tree.
- User-Centric Verification - Enables testing mobile applications by querying elements based on how a real user perceives the interface.
- Context Providers - Injects context providers and layout wrappers to simulate the application environment required for state management.
- Element Wait Conditions - Monitors the component tree until elements are removed, confirming successful unmounting or hiding of UI components.
- Scoped Queries - Allows restricting search queries to specific subtrees to isolate interactions within complex component structures.
- Presence Verifiers - Validates the presence and existence of components within the rendered structure during tests.
