substack/tape
Tape
Tape is a JavaScript testing framework and assertion library that serves as a test runner for Node.js and browser environments. It implements the Test Anything Protocol to provide a standardized, machine-readable format for test results.
The project functions as a cross-environment test harness, allowing the same test suites to be executed across both server-side and client-side environments while maintaining a consistent output protocol.
Its capabilities include validating value equality and truthiness, verifying exception handling, and coordinating asynchronous workflows. The framework also provides tools for managing test lifecycles, defining named test cases, and capturing function calls or property access.
The command line interface supports glob-based test discovery, module preloading, and the ability to filter specific files or folders from execution.
Features
- TAP Stream Outputs - Outputs test results in the standardized Test Anything Protocol (TAP) format.
- JavaScript Testing Frameworks - Implements a comprehensive framework for writing and running automated tests within JavaScript environments.
- Exception Validation - Includes specialized assertions to verify that function calls throw expected exceptions and match specific error patterns.
- Async Operation Coordinators - Coordinates the completion of asynchronous tests by tracking pending assertions.
- Cross-Environment Test Harnesses - Acts as a unified harness for executing a single test suite across both server-side and client-side JavaScript runtimes.
- TAP-Format Harnesses - Implements the Test Anything Protocol (TAP) to provide a standardized, machine-readable format for test results.
- Cross-Environment Test Execution - Enables the same test suites to be executed across both server-side and client-side environments.
- Test Result Reporters - Generates standardized test result reports using the TAP protocol for machine-readable consumption.
- Asynchronous Test Handling - Manages synchronization of asynchronous operations to ensure they complete before finishing tests.
- JavaScript Assertion Libraries - Provides a robust set of assertion tools for validating value equality, truthiness, and exception handling.
- Node.js Test Automation - Serves as a dedicated test runner tailored for automating tests within the Node.js runtime.
- Test Case Definitions - Enables the creation of named test cases with options for timeouts and skipping.
- Asynchronous Assertions - Supports asynchronous assertions that coordinate the order of execution and wait for non-blocking operations to complete.
- Value Equality Assertions - Provides a variety of comparison methods to validate truthiness, equality, and structural equivalence.
- CLI Test Runners - Provides a command-line interface for discovering and executing automated test suites.
- Unit Testing - Provides a framework for writing unit tests to verify the smallest pieces of JavaScript logic in isolation.
- Cross-Platform Test Execution - Enables the same test suites to be executed across both Node.js server-side and web browser environments.
- Stream Redirection - Allows routing test output to custom writeable streams instead of the console.
- Test Environment Preloading - Supports injecting configuration scripts into the global scope before executing tests.
- Test Output Streams - Generates readable TAP or object streams to bypass default console output.
- Property Access Spies - Provides spies to monitor and log get and set operations on object properties.
- CI Test Execution - Ensures full test suite execution and passage as a prerequisite for deployment within automated pipelines.
- Function Call Tracking - Includes utilities for recording function invocations, arguments, and return values as spies.
- Test Lifecycle Hooks - Provides mechanisms for executing setup and teardown logic after tests finish or when failures occur.
- Test Execution Filtering - Provides mechanisms to exclude specific test files or folders using command-line patterns.
- Test File Discovery - Automatically identifies and discovers test files using filesystem glob patterns.
- Module Preloading Hooks - Allows preloading specified modules into the environment to establish global configurations.
- Test Producers - A lightweight test harness for Node.js and browser environments.
- टेस्टिंग फ्रेमवर्क्स - TAP-generating test suite for Node and browsers.
