TypeStrong/ts-node
Ts Node
ts-node is a TypeScript execution engine and just-in-time transpiler for Node.js. It enables the direct execution of TypeScript files by converting them to JavaScript on the fly, removing the requirement for a manual pre-compilation build step. It also provides a TypeScript read-eval-print loop for evaluating expressions and testing code snippets in real time.
The project integrates with the Node.js module system as a loader hook to resolve and load files using native import syntax. It features a pluggable compiler interface that allows the use of external transpilers to accelerate execution and supports shebang-based execution to run scripts as standalone binaries.
Broad capabilities include configurable compilation and transformation scopes, optional type validation to balance startup speed with correctness, and source-map stack tracing to link runtime errors back to the original source code. The engine also supports programmatic registration for loading TypeScript files and provides the ability to create custom interactive shell services.
Features
- TypeScript Transpilers - Provides high-speed transpilation of TypeScript to JavaScript on the fly for immediate execution.
- TypeScript Execution - Enables the direct execution of TypeScript files by transpiling them to JavaScript on the fly.
- Interactive REPLs - Launches an interactive shell environment for evaluating TypeScript expressions and prototyping in real time.
- Node.js Development Utilities - Speeds up the Node.js development inner loop by transpiling TypeScript on the fly.
- Read-Eval-Print Loops - Provides an interactive read-eval-print loop for real-time execution and testing of TypeScript expressions.
- Module Resolvers - Implements configurable lookup engines to resolve import extensions and file paths for TypeScript modules.
- Module Loaders - Implements hooks that intercept and transform TypeScript files during the Node.js module loading process.
- Optional Validation - Allows skipping the type-checking phase during execution to reduce startup time.
- Validation Toggles - Allows switching between comprehensive type validation and fast transpilation to balance speed and correctness.
- Optional Type Validation - Allows developers to decouple type checking from code emission to significantly reduce startup time.
- JavaScript and TypeScript Debugging - Maps runtime stack traces back to the original TypeScript source code for faster debugging.
- Source Map Generators - Generates and utilizes source maps to link runtime error stack traces back to the original TypeScript source lines.
- Execution Environment Configurations - Manages execution environment settings using environment variables and configuration files to control code processing.
- TypeScript Compiler Configurations - Provides configurable settings for controlling TypeScript build and compilation behavior via flags and files.
- External Transpiler Integrations - Uses third party transpilers to accelerate the conversion of code during execution.
- Pluggable Compilers - Offers a pluggable interface to swap the default compiler for high-performance external transpilers.
- Source-To-Source Transpilers - Provides a pluggable compiler interface to use external source-to-source transpilers for faster execution.
- Validation Skipping - Bypasses the type-checking phase during execution to speed up startup and reduce processing time.
- Build Tools - Execution environment for running files directly.
