testing-library/react-hooks-testing-library
React Hooks Testing Library
This project is a specialized test harness and mocking utility designed for unit testing React hooks in isolation. It provides a simulated component environment that executes hook logic and tracks returned values without requiring a full user interface.
The library enables the verification of hook lifecycles, including mounting, updating, and unmounting phases. It features mechanisms for injecting properties to force re-renders and an asynchronous waiting system to ensure state updates are processed before assertions are run.
The toolset covers state management verification, automated lifecycle cleanup to prevent state leakage between tests, and the ability to trigger state updates to verify how hooks respond to changing inputs.
Features
- Hook Execution Wrappers - Executes hooks inside a minimal React component to simulate a real lifecycle and access hook state.
- Custom Hook Testing - Implements a specialized harness for verifying the state transitions and return values of custom hooks in isolation.
- Hook Return Value Tracking - Captures and tracks the latest return values of hooks during render cycles for external inspection.
- Hook Mocking Utilities - Provides a framework for injecting props and awaiting asynchronous updates within a simulated React environment.
- Test Harnesses - Implements a simulated environment (test harness) to validate hook logic without a full UI.
- Headless Render Cycle Controllers - Manages the timing of hook execution and state updates to ensure predictable behavior in headless environments.
- Asynchronous Polling Mechanisms - Provides polling mechanisms to wait for asynchronous state updates before running test assertions.
- Asynchronous Test Handling - Provides capabilities for managing tests that rely on asynchronous hook operations and promise resolutions.
- React Testing Utilities - Provides specialized utilities for unit testing React hooks in isolation by simulating a component environment.
- Component Prop Injection - Allows injecting dynamic properties into a wrapper component to trigger hook re-renders and test various inputs.
- Hook Property Injection - Passes custom arguments and initial values to hooks to verify behavior across different configurations.
- State Update Triggering - Provides capabilities to simulate user interactions and state changes to verify that hook return values update correctly.
- Hook Lifecycle Testing - Ensures that effects and cleanup functions within a hook execute correctly across all lifecycle phases.
- Test State Cleanup - Includes mechanisms to clear hook state and unmount components to prevent pollution between tests.
- Test Lifecycle Hooks - Provides mechanisms to unmount test components to trigger cleanup effects and hydrate for interaction.
- Test Lifecycle Hooks - Automatically executes cleanup functions after tests to remove rendered hooks and prevent state leakage.
- Hook State Verifications - Verifies that a hook correctly manages internal state and updates its output based on changing triggers.
- State Response Testers - Utilities for verifying how hooks respond to state changes by triggering re-renders and managing cleanup.
- Test-Controlled State Updates - Executes state updates and effects within a wrapper to ensure all changes finish before assertions.
