jestjs/jest
Jest
Jest is a JavaScript testing framework designed for writing and running automated test suites to verify the correctness of JavaScript and TypeScript code. It functions as a comprehensive toolset that integrates a test runner, a mocking and spying library, a snapshot testing tool, and a code coverage tool.
The framework distinguishes itself through snapshot testing, which records the serialized state of data structures to detect regressions in future executions. It also includes a mocking and spying library for simulating external dependencies and tracking function calls to isolate code during tests.
The project covers a broad range of capabilities including parallel and distributed test execution, code coverage analysis, and dependency isolation. It provides utilities for virtual timer manipulation, expectation assertions, and a file system watch mode for iterative development.
The system supports source transformation via build tool integration and offers configuration for execution policies and test environment settings.
Features
- JavaScript Application Testing - Provides a comprehensive framework for writing and running automated tests for JavaScript and TypeScript code.
- Code Coverage - Analyzes the codebase to identify untested sections by tracking executed lines during test runs.
- Testing Frameworks - Acts as a full-featured testing framework for writing and executing unit, behavioral, and integration tests.
- Build Tool Integrations - Integrates with external compilers and bundlers to transform source code into executable formats.
- Module Resolvers - Implements a custom module resolver to intercept Node.js loading for mock injection and file transformations.
- Test Environment Isolation - Creates a clean global execution context for every test file to ensure complete isolation and prevent state leakage.
- Code Coverage Tools - Injects runtime counters into source code to track and report which lines and branches are executed.
- Function Call Tracking - Provides a spying mechanism that records function invocations to verify passed arguments and total call counts.
- Snapshot Testing - Provides a system for recording serialized data structures and comparing them against baselines to detect regressions.
- Mocking and Spying Libraries - Ships an integrated mocking and spying library to simulate external dependencies and track function invocations.
- Snapshot Testing - Implements snapshot testing by serializing data structures to detect regressions via baseline comparisons.
- Snapshot Testing - A feature to record the serialized state of a value to a file and compare it against future executions.
- Dependency Mocking - Implements mechanisms for replacing module dependencies and system timers with controlled substitutes to isolate code.
- Test Execution and Orchestration - Manages the full lifecycle, execution, and reporting of automated test suites based on assertions.
- Assertion and Validation Utilities - Ships a comprehensive set of expectation assertions and equality logic for test validation.
- Test Execution Runners - Includes a powerful execution engine that manages the discovery, parallelization, and reporting of test suites.
- Worker Process Management - Distributes test suites across multiple isolated OS-level worker processes to maximize CPU utilization.
- Syntax Transformers - Integrates a transformation pipeline to transpile non-standard JavaScript and TypeScript before test execution.
- Reactive Watch Modes - Features an interactive watch mode that monitors the file system and automatically re-runs relevant tests.
- Dependency Graph Analyzers - Analyzes file relationships to determine and run only the specific tests affected by modified source code.
- Execution Policies - Offers global configuration settings for timeouts, environment options, and transformation rules.
- Test-Driven Development Workflow - Supports a TDD workflow through an interactive watch mode that provides immediate feedback during the Red-Green-Refactor cycle.
- Memory Leak Detection - Includes a utility for analyzing heap snapshots to identify and resolve memory leaks in the application.
- Test Configuration - Provides a system for defining project-specific settings through custom runners and type-safe configuration files.
- Test Reporters - Ships mechanisms for formatting and exporting test execution results into standard formats for CI/CD integration.
- Time Manipulation - Provides virtual clock manipulation to synchronously trigger asynchronous callbacks and simulate time passage.
- Test Coverage Collections - Gathers execution data across various file formats to identify untested sections of the codebase.
- Parallel Test Execution - Executes test suites across multiple isolated worker processes to maximize CPU utilization and reduce completion time.
- Regression Testing Suites - Offers comprehensive regression testing capabilities, including the ability to detect unexpected changes in functionality.
- Timer Mocks - Provides tools to override native timers and simulate time-dependent logic.
- Change-Based Test Selection - Allows running only the tests affected by changes in specific files or since a version control revision.
- Test Sharding - Supports test sharding to distribute large test suites across multiple machines for CI stability and speed.
- Test Suite Filters - Implements pattern-based inclusion and exclusion of specific files and directories from the test suite.
- Global Test Lifecycle Hooks - Provides global lifecycle hooks that execute specifically before all tests start and after they complete.
- Testing - Comprehensive JavaScript testing framework.
- Testing Utilities - Comprehensive JavaScript testing framework.
