-
Notifications
You must be signed in to change notification settings - Fork 12.5k
Compiler Options
Daniel Rosenwasser edited this page Nov 11, 2015
·
38 revisions
Option | Shorthand | Description |
---|---|---|
--declaration |
-d |
Generates corresponding '.d.ts' file. |
--help |
-h |
Print help message. |
--version |
-v |
Print the compiler's version. |
--module |
-m |
Specify module code generation: 'commonjs', 'amd', 'system', or 'umd'. Only 'amd' and 'system' can be used in conjunction with --outFile . |
--project |
-p |
Compile the project in the given directory. The directory needs to contain a tsconfig.json file to direct compilation. See tsconfig.json documentation for more details. |
--target |
-t |
Specify ECMAScript target version: 'ES3' (default), 'ES5', or 'ES6'[1] |
--watch |
-w |
Run the compiler in watch mode. Watch input files and trigger recompilation on changes. |
--charset |
The character set of the input files. | |
--diagnostics |
Show diagnostic information. | |
--emitBOM |
Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. | |
--emitDecoratorMetadata [1]
|
Emit design-type metadata for decorated declarations in source. See issue #2577 for details. | |
--experimentalAsyncFunctions |
Support ES7-proposed asynchronous functions using the async /await keywords. |
|
--inlineSourceMap |
Emit a single file with source maps instead of having a separate file. | |
--inlineSources |
Emit the source alongside the sourcemaps within a single file; requires --inlineSourceMap to be set. |
|
--isolatedModules |
Unconditionally emit imports for unresolved files. | |
--jsx |
Support JSX in '.tsx' files: 'React' or 'Preserve'. See JSX. | |
--listFiles |
Print names of files part of the compilation. | |
--locale |
The locale to use to show error messages, e.g. en-us. | |
--mapRoot |
Specifies the location where debugger should locate map files instead of generated locations. Use this flag if the .map files will be located at run-time in a different location than than the .js files. The location specified will be embedded in the sourceMap to direct the debugger where the map files where be located. | |
--moduleResolution [1]
|
Determine how modules get resolved. Either 'node' for Node.js/io.js style resolution, or 'classic' (default). | |
--newLine |
Use the specified end of line sequence to be used when emitting files: 'CRLF' (dos) or 'LF' (unix)." | |
--noEmit |
Do not emit outputs. | |
--noEmitOnError |
Do not emit outputs if any errors were reported. | |
--noEmitHelpers |
Do not generate custom helper functions like __extends in compiled output. |
|
--noImplicitAny |
Raise error on expressions and declarations with an implied 'any' type. | |
--noLib |
Do not include the default library file (lib.d.ts). | |
--noResolve |
Do not add triple-slash references or module import targets to the list of compiled files. | |
--out |
DEPRECATED. Use --outFile instead. |
|
--outDir |
Redirect output structure to the directory. | |
--outFile |
Concatenate and emit output to single file. The order of concatenation is determined by the list of files passed to the compiler on the command line along with triple-slash references and imports. See output file order documentation for more details. | |
--preserveConstEnums |
Do not erase const enum declarations in generated code. See const enums documentation for more details. | |
--removeComments |
Remove all comments except copy-right header comments beginning with /!*
|
|
--rootDir |
Specifies the root directory of input files. Only use to control the output directory structure with --outDir . |
|
--sourceMap |
Generates corresponding '.map' file. | |
--sourceRoot |
Specifies the location where debugger should locate TypeScript files instead of source locations. Use this flag if the sources will be located at run-time in a different location than that at design-time. The location specified will be embedded in the sourceMap to direct the debugger where the source files where be located. | |
--stripInternal [1]
|
Do not emit declarations for code that has an /** @internal */ JSDoc annotation. |
|
--suppressImplicitAnyIndexErrors |
Suppress --noImplicitAny errors for indexing objects lacking index signatures. See issue #1232 for more details. |
[1] These options are experimental.
- For tsconfig.json see tsconfig.json
- For Setting the compiler options in MSBuild projects see Setting Compiler Options in MSBuild projects
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