testing-library/react-hooks-testing-library
React Hooks Testing Library
该项目是一个专门的测试工具和 Mock 实用程序，旨在隔离测试 React Hook。它提供了一个模拟组件环境，用于执行 Hook 逻辑并跟踪返回的值，而无需完整的用户界面。
该库支持验证 Hook 的生命周期，包括挂载、更新和卸载阶段。它具有注入属性以强制重新渲染的机制，以及一个异步等待系统，以确保在运行断言前处理状态更新。
该工具集涵盖了状态管理验证、防止测试间状态泄漏的自动化生命周期清理，以及触发状态更新以验证 Hook 如何响应输入变化的能力。
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.
