Recommended Node TSConfig settings
You can let TypeScript compile as little as possible by knowing what the baseline support for ECMAScript features are available in your node version
You can also use https://github.com/tsconfig/bases/ to find tsconfig.jsons to extend, simplifying your own JSON files to just the options for your project.
To update this file, you can use node.green to map to the different options in microsoft/typescript@src/lib
Node 20
{
"compilerOptions": {
"lib": ["ES2023"],
"module": "node16",
"target": "ES2022"
}
}
Node 18
{
"compilerOptions": {
"lib": ["ES2023"],
"module": "node16",
"target": "ES2022"
}
}
Note: All versions of Node 18 support all ES2023 runtime features, so lib can be safely set to ES2023.
Node 16
{
"compilerOptions": {
"lib": ["ES2021"],
"module": "node16",
"target": "ES2021"
}
}
Note: Due to a V8 bug, one rarely-used ES2020 feature was incorrectly implemented in Node <16.3.0 - "spread parameters after optional chaining"; see issue 46325. If you use this feature and need to support versions of Node before 16.3.0, you may need to drop target to ES2019.
Node 14
{
"compilerOptions": {
"lib": ["ES2020"],
"module": "node16",
"target": "ES2020"
}
}
Note: Due to a V8 bug, one rarely-used ES2020 feature was incorrectly implemented in all releases of Node 14 - "spread parameters after optional chaining"; see issue 46325. If you use this feature, you may need to drop target to ES2019.
Node 12
{
"compilerOptions": {
"lib": ["ES2019"],
"module": "node16",
"target": "ES2019"
}
}
Node 10
{
"compilerOptions": {
"lib": ["es2018"],
"module": "commonjs",
"target": "es2018"
}
}
Node 8
{
"compilerOptions": {
"lib": ["es2017"],
"module": "commonjs",
"target": "es2017"
}
}
User documentation
News
Debugging TypeScript
- Performance
- Performance-Tracing
- Debugging-Language-Service-in-VS-Code
- Getting-logs-from-TS-Server-in-VS-Code
- JavaScript-Language-Service-in-Visual-Studio
- Providing-Visual-Studio-Repro-Steps
Contributing to TypeScript
- Contributing to TypeScript
- TypeScript Design Goals
- Coding Guidelines
- Useful Links for TypeScript Issue Management
- Writing Good Design Proposals
- Compiler Repo Notes
- Deployment
Building Tools for TypeScript
- Architectural Overview
- Using the Compiler API
- Using the Language Service API
- Standalone Server (tsserver)
- TypeScript MSBuild In Depth
- Debugging Language Service in VS Code
- Writing a Language Service Plugin
- Docker Quickstart
FAQs
The Main Repo