Table of Contents

Overview

Features

Installation

Usage

Command Line

Shebang

node flags and other tools

Programmatic

Configuration

CLI flags

Via tsconfig.json (recommended)

@tsconfig/bases

Default config

`node` flags

Options

CLI Options

help

version

eval

print

interactive

esm

TSConfig Options

project

skipProject

cwdMode

compilerOptions

showConfig

Typechecking

transpileOnly

typeCheck

compilerHost

files

ignoreDiagnostics

Transpilation Options

ignore

skipIgnore

compiler

swc

transpiler

preferTsExts

Diagnostic Options

logError

pretty

TSNODEDEBUG

Advanced Options

require

cwd

emit

scope

scopeDir

moduleTypes

TSNODEHISTORY

noExperimentalReplAwait

experimentalResolver

experimentalSpecifierResolution

API Options

SWC

CommonJS vs native ECMAScript modules

CommonJS

Native ECMAScript modules

Troubleshooting

Configuration

Common errors

`TSError`

`SyntaxError`

Unsupported JavaScript syntax

`ERRREQUIREESM`

`ERRUNKNOWNFILEEXTENSION`

Missing Types

npx, yarn dlx, and nodemodules

Performance

Skip typechecking

With typechecking

Advanced

How it works

Ignored files

File extensions

Skipping `nodemodules`

Skipping pre-compiled TypeScript

Scope by directory

Ignore by regexp

paths and baseUrl

Why is this not built-in to ts-node?

Third-party compilers

Transpilers

Third-party plugins

Write your own plugin

Module type overrides

Caveats

API

Recipes

Watching and restarting

AVA

CommonJS

Native ECMAScript modules

Gulp

IntelliJ and Webstorm

Mocha

Mocha 7 and newer

Mocha <=6

Tape

Visual Studio Code

Other

License