pgte/nock

Features

• API Request Mocking - Provides tools to intercept network requests and simulate server responses to mimic external API behavior.
• Response Recordings - Returns pre-recorded fixtures or predefined data packets to the application instead of making live network calls.
• Request Matching Engines - Employs a matching engine to target dynamic hostnames, paths, and request bodies for selecting correct mock responses.
• Network Request Interceptors - Captures and redirects outbound traffic to simulate external API behavior for automated testing.
• HTTP Mocking Libraries - Provides a Node.js library for intercepting outgoing HTTP requests and returning predefined responses.
• API Response Recordings - Provides a utility to record real network interactions and save them as reusable data files for playback.
• HTTP Mock Servers - Functions as a simulated server environment that validates request expectations and returns mock data.
• Network Fixture Recorders - Captures real HTTP interactions from a live system to create reusable mock data for development and testing.
• Network Interaction Recorders - Captures real network interactions and saves them as reusable data files for playback during tests.
• Response Simulators - Simulates specific server behaviors, such as custom error codes or artificial network latency, to test application resilience.
• HTTP Mocking - Intercepts network requests to return predefined responses and isolate application logic from external services.
• Mock Expectation Verifiers - Validates that specific network requests occurred and asserts that all expected calls were completed.
• Request-Response Interceptors - Redirects traffic from the native network stack to a virtual response handler based on the target hostname.
• Request Validation - Verifies that the application sends the correct parameters and headers to specific endpoints.
• Module Monkey Patching - Overrides core Node.js HTTP and HTTPS modules to intercept outgoing requests before they reach the network.
• Outbound Network Blockers - Blocks requests to unmocked hosts to prevent unexpected outbound network calls during test execution.
• Network Latency Simulators - Introduces artificial delays to outgoing HTTP responses to verify timeout handling and race conditions.
• Test Isolation - Prevents external dependencies from affecting test results by simulating API behavior and blocking unplanned outbound traffic.
• Mock State Resetting - Maintains a global map of active mocks and expectations that can be cleared or reset between test cycles.
• Latency and Chunking Simulators - Introduces configurable millisecond delays to HTTP responses to verify timeout handling and race conditions.
• Lifecycle Management - Provides controls to start, stop, or reset network interceptors to maintain a clean state between test scenarios.
• Testing Frameworks - HTTP mocking and expectations.

Star history