callstack/react-native-testing-library
React Native Testing Library
Ce projet est un framework de test conçu pour les applications React Native, fournissant une suite d'outils pour rendre les composants dans un environnement mémoire contrôlé. Il permet aux développeurs de vérifier le comportement et la structure des interfaces mobiles en simulant les interactions utilisateur et en surveillant les transitions du cycle de vie des composants. En isolant les composants du reste de l'application, il garantit que les tests restent stables et indépendants.
Le framework se distingue par une approche axée sur l'accessibilité, privilégiant les attributs orientés utilisateur tels que les rôles, les étiquettes et le contenu textuel lors de l'interrogation de l'arbre des composants. Cette méthodologie garantit que les tests reflètent la manière dont un utilisateur réel perçoit et interagit avec l'interface, plutôt que de se baser sur des détails d'implémentation internes. Il inclut également un support robuste pour les opérations asynchrones, synchronisant automatiquement les assertions avec les mises à jour d'état en arrière-plan et le rendu différé de l'interface pour éviter les conditions de concurrence.
Au-delà du rendu et de l'interaction, la bibliothèque offre des capacités complètes pour valider l'état de l'interface, inspecter les styles des composants et vérifier les propriétés d'accessibilité. Elle prend en charge le test des hooks personnalisés en isolation, la gestion d'arbres de composants complexes via l'injection de fournisseurs, et la vérification structurelle via des snapshots. Ces fonctionnalités permettent une assurance qualité approfondie pour divers scénarios d'interface mobile.
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.
