substack/tape
Tape
Tape 是一个 JavaScript 测试框架和断言库，用作 Node.js 和浏览器环境的测试运行器。它实现了 Test Anything Protocol (TAP)，为测试结果提供了一种标准化的、机器可读的格式。
该项目作为跨环境测试工具，允许在服务器端和客户端环境中执行相同的测试套件，同时保持一致的输出协议。
其功能包括验证值相等性和真值、验证异常处理以及协调异步工作流。该框架还提供了用于管理测试生命周期、定义命名测试用例以及捕获函数调用或属性访问的工具。
命令行界面支持基于 glob 的测试发现、模块预加载，以及从执行中过滤特定文件或文件夹的功能。
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.
