tsc CLI Options

CLI로 사용하기 (Using the CLI)

로컬에서 tsc를 실행하면 tsconfig.json가 정의한 가장 가까운 프로젝트를 컴파일하고, 원하는 파일 glob을 전달하여 TypeScript 파일 집합을 컴파일할 수 있습니다.

sh
# tsconfig.json에 대한 fs를 역방향으로 검토하여 컴파일 실행
tsc
# 컴파일러 기본값으로 index.ts만 트랜스파일
tsc index.ts
# 기본 설정으로 src 폴더 안에 모든 .ts 파일을 트랜스파일
tsc src/*.ts
# tsconfig.json의 컴파일러 설정으로 src 폴더 안에 모든 .ts 파일을 트랜스파일
tsc --project tsconfig.json src/*.ts

컴파일러 옵션 (Compiler Options)

tsconfig의 컴파일러 옵션에 대한 더 많은 정보를 찾는다면, 베타 TSConfig 레퍼런스를 v2 사이트에서 확인하세요.

옵션 타입 기본값 설명
--allowJs boolean false JavaScript 파일의 컴파일을 허용합니다
--allowSyntheticDefaultImports boolean module === "system" 또는 --esModuleInterop default export가 없는 모듈에서 default imports를 허용합니다. 코드 방출에는 영향을 주지 않으며, 타입 검사만 수행합니다.
--allowUmdGlobalAccess boolean false 모듈에서 전역 UMD 접근을 허용합니다.
--allowUnreachableCode boolean false 도달할 수 없는 코드에 대한 오류를 보고하지 않습니다.
--allowUnusedLabels boolean false 사용되지 않는 레이블에 대한 오류를 보고하지 않습니다.
--alwaysStrict boolean false strict mode에서 파싱하고 각 소스 파일에 대해 "use strict"를 내보냅니다.
--assumeChangesOnlyAffectDirectDependencies boolean false 파일 안에서의 변경은 파일이 직접 의존하는 파일에만 영향을 미친다고 가정하고 ‘—incremental’ 및 ‘-watch’로 다시 컴파일 합니다.
--baseUrl string 비-상대적 모듈 이름을 해석하기 위한 기본 디렉터리. 자세한 내용은 모듈 해석 문서을 참조하세요.
--build
-b
boolean false 프로젝트 레퍼런스에서 지정한 이 프로젝트와 프로젝트의 모든 의존성을 빌드 합니다. 이 플래그는 이 페이지의 다른 플래그들과는 호환되지 않음에 유의하세요 자세한 내용은 여기를 보세요.
--charset string "utf8" 입력 파일의 문자 집합입니다.
--checkJs boolean false .js 파일에 오류를 보고합니다. --allowJs와 함께 사용하세요.
--composite boolean true TypeScript가 프로젝트를 컴파일하기 위해 참조된 프로젝트의 출력을 찾을 위치를 결정할 수 있는지 확인합니다.
--declaration
-d
boolean false 해당하는 .d.ts 파일을 생성합니다.
--declarationDir string 생성된 선언 파일의 출력 디렉토리입니다.
--declarationMap boolean false 해당하는 ‘.d.ts’파일 각각에 대한 소스 맵을 생성합니다.
--diagnostics boolean false 진단 정보를 보여줍니다.
--disableSizeLimit boolean false JavaScript 프로젝트의 사이즈 제한을 비활성화합니다.
--downlevelIteration boolean false ES5 또는 ES3를 대상으로 할 때 for..of, 스프레드와 구조분해할당에서 이터러블을 완전히 지원합니다.
--emitBOM boolean false 출력 파일의 시작 부분에 UTF-8 바이트 순서표(BOM)를 내보냅니다.
--emitDeclarationOnly boolean false ‘.d.ts’ 선언 파일만 내보냅니다.
--emitDecoratorMetadata[1] boolean false 소스에 데코레이터 선언에 대한 설계-타입 메타 데이터를 내보냅니다. 자세한 내용은 #2577 이슈을 참조하세요.
--esModuleInterop boolean false 런타임 바벨 생태계 호환성을 위한 __importStar__importDefault 헬퍼를 내보내고 타입 시스템 호환성을 위해 --allowSyntheticDefaultImports를 활성화합니다.
--experimentalDecorators[1] boolean false ES 데코레이터에 대한 실험적인 지원을 사용하도록 활성화합니다.
--extendedDiagnostics boolean false 자세한 진단 정보를 표시합니다
--forceConsistentCasingInFileNames boolean false 동일 파일 참조에 대해 일관성 없는 대소문자를 비활성화합니다.
--generateCpuProfile string profile.cpuprofile 주어진 경로에 cpu 프로필을 생성합니다. 파일 경로 대신 존재하는 디렉터리 이름을 전달하면 타임스탬프 이름이 지정된 프로필이 그 디렉터리에 대신 생성됩니다.
--help
-h
도움말을 출력합니다.
--importHelpers boolean false tslib에서 방출된 헬퍼를 import 합니다. (예. __extends, __rest, 등..)
--importsNotUsedAsValues string remove 타입을 위해서만 사용하는 import를 위한 내보내기/검사 동작을 지정합니다. "remove""preserve"는 사이드 이펙트를 위해 사용하지 않는 import를 내보낼지 지정하고, "error"는 타입을 위해서만 사용하는 import는 import type으로 작성하게 강제합니다.
--incremental boolean composite이 켜져있으면 true 아니면 false 이전 컴파일에서 디스크의 파일로 정보를 읽거나/기록하여 증분 컴파일을 활성화합니다. 이 파일은 --tsBuildInfoFile 플래그로 컨트롤합니다.
--inlineSourceMap boolean false 별도의 파일 대신 소스 맵으로 단일 파일을 내보냅니다.
--inlineSources boolean false 단일 파일 내에서 소스 맵과 함께 소스를 내보냅니다. --inlineSourceMap 또는 --sourceMap을 설정해야 합니다.
--init TypeScript 프로젝트를 초기화하고 tsconfig.json 파일을 생성합니다.
--isolatedModules boolean false 추가 검사를 수행하여 별도의 컴파일 (예를 들어 트랜스파일된 모듈 혹은 @babel/plugin-transform-typescript) 이 안전한지 확인합니다.
--jsx string "Preserve" .tsx 파일에서 JSX 지원: "React", "Preserve", "react-native". JSX를 확인하세요.
--jsxFactory string "React.createElement" 리액트 JSX 방출을 대상으로 할 때 사용할 JSX 팩토리 함수를 지정합니다. 예: React.createElement 또는 h.
--keyofStringsOnly boolean false keyof를 문자열 값으로 된 프로퍼티 이름에만 적용합니다 (숫자나 심벌에서는 안됨).
--useDefineForClassFields boolean false 클래스 필드를 ECMAScript-표준 시맨틱으로 내보냅니다.
--lib string[] 컴파일에 포함될 라이브러리 파일 목록입니다.
가능한 값은 다음과 같습니다:
ES5
ES6
ES2015
ES7
ES2016
ES2017
ES2018
ESNext
DOM
DOM.Iterable
WebWorker
ScriptHost
ES2015.Core
ES2015.Collection
ES2015.Generator
ES2015.Iterable
ES2015.Promise
ES2015.Proxy
ES2015.Reflect
ES2015.Symbol
ES2015.Symbol.WellKnown
ES2016.Array.Include
ES2017.object
ES2017.Intl
ES2017.SharedMemory
ES2017.String
ES2017.TypedArrays
ES2018.Intl
ES2018.Promise
ES2018.RegExp
ESNext.AsyncIterable
ESNext.Array
ESNext.Intl
ESNext.Symbol

주의사항: --lib가 지정되지 않으면 라이브러리의 기본 리스트가 삽입됩니다. 주입되는 기본 라이브러리는 다음과 같습니다:
--target ES5: DOM,ES5,ScriptHost
--target ES6: DOM,ES6,DOM.Iterable,ScriptHost
--listEmittedFiles boolean false 컴파일의 일부로 생성된 파일의 이름을 출력합니다.
--listFiles boolean false 컴파일에 포함된 파일의 이름을 출력합니다.
--locale string (플랫폼 별) 오류 메시지를 표시하는 데 사용할 지역화, 예: en-us.
가능한 값은 다음과 같습니다:
► 영어 (US): en
► 체코어: cs
► 독일어: de
► 스페인어: es
► 프랑스어: fr
► 이탈리아어: it
► 일본어: ja
► 한국어: ko
► 폴란드어: pl
► 포르투갈어(브라질): pt-BR
► 러시아어: ru
► 터키어: tr
► 중국어 간체: zh-CN
► 중국어 번체: zh-TW
--mapRoot string 디버거가 생성된 위치가 아닌 맵 파일의 위치를 지정합니다. .map 파일이 .js 파일과 다른 위치에 런타임 시 위치할 경우 이 옵션을 사용하세요. 지정된 위치는 sourceMap에 포함되어 맵 파일이 위치할 디버거를 지정합니다. 이 플래그는 지정된 경로를 작성하지 않고 해당 위치에 맵 파일을 생성합니다. 대신 파일을 지정된 경로로 이동하는 빌드 후 단계를 작성하십시오.
--maxNodeModuleJsDepth number 0 node_modules 및 로드 JavaScript 파일 아래에서 검색할 최대 의존성 깊이. --allowJs에만 적용됩니다.
--module
-m
string target === "ES3" or "ES5" ? "CommonJS" : "ES6" 모듈 코드 생성 지정: "None", "CommonJS", "AMD", "System", "UMD", "ES6", "ES2015" 또는 "ESNext".
"AMD""System"--outFile과 함께 사용할 수 있습니다.
"ES6""ES2015" 값은 "ES5" 또는 이하를 대상으로 할 때 사용할 수 있습니다.
--moduleResolution string module === "AMD" or "System" or "ES6" ? "Classic" : "Node" 모듈 해석 방법 결정. Node.js/io.js 스타일 해석의 경우, "Node" 또는 "Classic" 중 하나입니다. 자세한 내용은 모듈 해석 문서를 참조하세요.
--newLine string (플랫폼 별) 파일을 내보낼 때 사용되는 지정된 라인 끝의 시퀀스 사용: "crlf" (윈도우) 또는 "lf" (유닉스).”
--noEmit boolean false 출력을 내보내지 않습니다.
--noEmitHelpers boolean false 컴파일된 출력에서는 __extends와 같은 커스텀 헬퍼 함수를 생성하지 않습니다.
--noEmitOnError boolean false 오류가 보고된 경우 출력을 내보내지 않습니다.
--noErrorTruncation boolean false 오류 메세지를 줄이지 않습니다.
--noFallthroughCasesInSwitch boolean false 스위치 문에 fallthrough 케이스에 대한 오류를 보고합니다.
--noImplicitAny boolean false any 타입으로 암시한 표현식과 선언에 오류를 발생시킵니다.
--noImplicitReturns boolean false 함수의 모든 코드 경로에 반환값이 없을 때 오류를 보고합니다.
--noImplicitThis boolean false any 타입으로 암시한 this 표현식에 오류를 보고합니다.
--noImplicitUseStrict boolean false 모듈 출력에 "use strict" 지시자를 내보내지 않습니다.
--noLib boolean false 기본 라이브러리 파일(lib.d.ts)은 포함하지 않습니다.
--noResolve boolean false 컴파일된 파일 목록에 트리플-슬래시 참조 또는 모듈 임포트 대상을 추가하지 않습니다.
--noStrictGenericChecks boolean false 함수 타입에서 제네릭 시그니처의 엄격한 검사를 비활성화합니다.
--noUnusedLocals boolean false 사용하지 않는 지역 변수에 대한 오류를 보고합니다.
--noUnusedParameters boolean false 사용하지 않는 매개 변수에 대한 오류를 보고합니다.
--out string 더 이상 사용하지 않습니다. --outFile을 대신 사용합니다.
--outDir string 출력 구조를 디렉토리로 리다이렉트합니다.
--outFile string 출력을 단일 파일로 연결하여 방출합니다. 연결의 순서는 컴파일러에 전달된 파일 목록과 트리플-슬래시 참조 그리고 import와 함께 결정됩니다. 자세한 내용은 출력 파일 순서 문서를 참조하세요.
paths[2] Object baseUrl을 기준으로 관련된 위치에 모듈 이름의 경로 매핑 목록을 나열합니다. 자세한 내용은 모듈 해석 문서를 참조하세요.
--preserveConstEnums boolean false 생성된 코드에 const enum 선언을 지우지 않습니다. 자세한 내용은 const 열거형 문서를 참조하세요.
--preserveSymlinks boolean false symlinks를 실제 경로로 해석하지 않습니다. symlinked된 파일을 실제 파일처럼 다룹니다.
--preserveWatchOutput boolean false 스크린을 지우는 대신에 예전 콘솔 출력을 감시 모드로 남겨둡니다
--pretty boolean 다른 프로그램으로 파이프하거나 출력을 파일로 리다이렉션하지 않으면 true 에러와 메시지를 색과 컨텍스트를 사용해서 스타일 지정합니다.
--project
-p
string 유효한 설정 파일이 지정된 프로젝트를 컴파일하세요.
이 인수는 유효한 JSON 설정 파일의 파일 경로일 수도 있고 tsconfig.json 파일이 포함된 디렉토리의 경로일 수도 있습니다.
자세한 내용은 tsconfig.json를 참조하세요.
--reactNamespace string "React" 더 이상 사용하지 않습니다. --jsxFactory를 대신 사용합니다.
"react" JSX emit을 대상으로 할 때 createElement__spread에 호출된 객체를 지정합니다.
--removeComments boolean false /*!로 시작하는 copy-right 헤더 주석을 제외한 모든 주석을 제거합니다.
--resolveJsonModule boolean false .json 확장자로 import된 모듈을 포함합니다.
--rootDir string (공통 루트 디렉토리는 input files 리스트에서 처리됩니다) 입력 파일의 루트 디렉토리를 지정합니다. --outDir로 출력 디렉토리 구조를 제어하기 위해서만 사용합니다.
rootDirs[2] string[] 런타임 시 결합된 컨텐츠가 프로젝트의 구조를 나타내는 루트 폴더 목록입니다. 자세한 내용은 모듈 해석 문서를 참조하세요.
--showConfig boolean false 다른 입력 옵션 및 구성 파일을 사용하여 빌드를 실제로 실행하는 대신 출력에 마지막 암시적 구성 파일을 표시하십시오.
--skipDefaultLibCheck boolean false 더 이상 사용하지 않습니다. --skipLibCheck를 대신 사용합니다.
기본 라이브러리 선언 파일의 타입 검사를 건너뜁니다.
--skipLibCheck boolean false 모든 선언 파일(*.d.ts)의 타입 검사를 건너뜁니다.
--sourceMap boolean false 해당하는 .map 파일을 생성합니다.
--sourceRoot string 디버거가 소스 위치 대신 TypeScript 파일을 찾아야 하는 위치를 지정합니다. 설계 시점에 소스가 아닌 런타임에 소스가 있는 경우 이 옵션을 사용하세요. 지정한 위치는 소스 파일이 위치할 디버깅 위치를 지정하기 위해 소스 맵에 포함됩니다.
--strict boolean false 모든 엄격한 타입 검사 옵션을 활성화합니다.
--strict를 활성화하면 --noImplicitAny, --noImplicitThis, --alwaysStrict, --strictNullChecks--strictFunctionTypes이 가능합니다.
--strictBindCallApply boolean false 함수에서 bind, call 그리고 apply 메서드의 더 엄격한 검사를 활성화합니다.
--strictFunctionTypes boolean false 함수 타입에 대한 bivariant 매개변수를 비활성화합니다.
--strictPropertyInitialization boolean false undefined가 아닌 클래스 프로퍼티가 생성자에서 초기화 되도록 합니다. 이 옵션을 적용하려면 --strictNullChecks가 활성화되어야 합니다.
--strictNullChecks boolean false 엄격한 null 검사 모드에서는 nullundefined 값이 모든 타입의 도메인에 있지 않고 그 자체와 any만 할당할 수 있습니다(한 가지 예외사항은 undefined 또한 void에 할당 가능하다는 것입니다).
--suppressExcessPropertyErrors boolean false 객체 리터럴에 대한 프로퍼티 초과 검사를 억제합니다.
--suppressImplicitAnyIndexErrors boolean false 인덱스 시그니처가 없는 객체를 인덱싱하는 경우 --noImplicitAny 억제합니다. 오류를 시그니처 자세한 내용은 #1232 이슈를 참조하세요.
--target
-t
string "ES3" ECMAScript 대상 버전 지정:
"ES3" (기본 값)
"ES5"
"ES6"/"ES2015"
"ES2016"
"ES2017"
"ES2018"
"ES2019"
"ES2020"
"ESNext"

주의사항: "ESNext"는 최신 ES 제안 기능을 대상으로 합니다.
--traceResolution boolean false 모듈 해석 로그 메세지를 보고합니다.
--tsBuildInfoFile string .tsbuildinfo 증분 빌드 정보를 저장할 파일을 지정합니다.
--types string[] 타입 정의가 포함될 이름의 목록. 자세한 내용은 @types, —typeRoots 및 —types를 참조하세요.
--typeRoots string[] 타입 정의가 포함될 폴더의 목록. 자세한 내용은 @types, —typeRoots 및 —types를 참조하세요.
--version
-v
컴파일러의 버전을 출력합니다.
--watch
-w
컴파일러를 감시 모드로 실행합니다. 입력 파일을 감시하여 변경 시 다시 컴파일합니다. 감시 파일과 디렉터리의 구현은 환경 변수를 사용하여 구성합니다. 더 자세한 내용은 감시 구성하기를 보세요.
  • [1] 이 옵션은 실험단계입니다.
  • [2] 이 옵션은 tsconfig.json에서만 허용되며 커맨드 라인에서는 허용되지 않습니다.

CLI Commands

Flag Type
--all

boolean

Show all compiler options.

--help

boolean

Gives local information for help on the CLI.

--init

boolean

Initializes a TypeScript project and creates a tsconfig.json file.

--listFilesOnly

boolean

Print names of files that are part of the compilation and then stop processing.

--locale

string

Set the language of the tsc output

--project

string

Compile the project given the path to its configuration file, or to a folder with a 'tsconfig.json'.

--showConfig

boolean

Print the final configuration instead of building.

--version

boolean

Print the compiler's version.

Build Options

Flag Type
--build

boolean

Build one or more projects and their dependencies, if out of date

--clean

boolean

Delete the outputs of all projects.

--dry

boolean

Show what would be built (or deleted, if specified with '--clean')

--force

boolean

Build all projects, including those that appear to be up to date.

--verbose

boolean

Enable verbose logging.

Watch Options

Flag Type
--excludeDirectories

list

Remove a list of directories from the watch process.

--excludeFiles

list

Remove a list of files from the watch mode's processing.

--fallbackPolling

fixedinterval, priorityinterval, dynamicpriority 또는 fixedchunksize

Specify what approach the watcher should use if the system runs out of native file watchers.

--synchronousWatchDirectory

boolean

Synchronously call callbacks and update the state of directory watchers on platforms that don`t support recursive watching natively.

--watch

boolean

Watch input files.

--watchDirectory

usefsevents, fixedpollinginterval, dynamicprioritypolling 또는 fixedchunksizepolling

Specify how directories are watched on systems that lack recursive file-watching functionality.

--watchFile

fixedpollinginterval, prioritypollinginterval, dynamicprioritypolling, fixedchunksizepolling, usefsevents 또는 usefseventsonparentdirectory

Specify how the TypeScript watch mode works.

Compiler Flags

Flag Type Default
--allowArbitraryExtensions

boolean

false

Enable importing files with any extension, provided a declaration file is present.

--allowImportingTsExtensions

boolean

false

Allow imports to include TypeScript file extensions.

--allowJs

boolean

false

Allow JavaScript files to be a part of your program. Use the checkJS option to get errors from these files.

--allowSyntheticDefaultImports

boolean

true if esModuleInterop is enabled, module is system, or moduleResolution is bundler; false otherwise.

Allow 'import x from y' when a module doesn't have a default export.

--allowUmdGlobalAccess

boolean

false

Allow accessing UMD globals from modules.

--allowUnreachableCode

boolean

Disable error reporting for unreachable code.

--allowUnusedLabels

boolean

Disable error reporting for unused labels.

--alwaysStrict

boolean

true if strict; false otherwise.

Ensure 'use strict' is always emitted

--assumeChangesOnlyAffectDirectDependencies

boolean

false

Have recompiles in projects that use incremental and watch mode assume that changes within a file will only affect files directly depending on it.

--baseUrl

string

Set a baseurl for relative module names

--charset

string

utf8

Manually set the text encoding for reading files

--checkJs

boolean

false

Enable error reporting in type-checked JavaScript files.

--composite

boolean

false

Enable constraints that allow a TypeScript project to be used with project references.

--customConditions

list

Conditions to set in addition to the resolver-specific defaults when resolving imports.

--declaration

boolean

true if composite; false otherwise.

Generates .d.ts files from TypeScript and JavaScript files in your project.

--declarationDir

string

Specify the output directory for generated declaration files.

--declarationMap

boolean

false

Create sourcemaps for d.ts files.

--diagnostics

boolean

false

Output compiler performance information after building.

--disableReferencedProjectLoad

boolean

false

Reduce the number of projects loaded automatically by TypeScript.

--disableSizeLimit

boolean

false

Remove the 20mb cap on total source code size for JavaScript files in the TypeScript language server.

--disableSolutionSearching

boolean

false

Opt a project out of multi-project reference checking when editing.

--disableSourceOfProjectReferenceRedirect

boolean

false

Disable preferring source files instead of declaration files when referencing composite projects.

--downlevelIteration

boolean

false

Emit more compliant, but verbose and less performant JavaScript for iteration.

--emitBOM

boolean

false

Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files.

--emitDeclarationOnly

boolean

false

Only output d.ts files and not JavaScript files.

--emitDecoratorMetadata

boolean

false

Emit design-type metadata for decorated declarations in source files.

--esModuleInterop

boolean

true if module is node16 or nodenext; false otherwise.

Emit additional JavaScript to ease support for importing CommonJS modules. This enables allowSyntheticDefaultImports for type compatibility.

--exactOptionalPropertyTypes

boolean

false

Interpret optional property types as written, rather than adding undefined.

--experimentalDecorators

boolean

false

Enable experimental support for TC39 stage 2 draft decorators.

--explainFiles

boolean

false

Print files read during the compilation including why it was included.

--extendedDiagnostics

boolean

false

Output more detailed compiler performance information after building.

--forceConsistentCasingInFileNames

boolean

true

Ensure that casing is correct in imports.

--generateCpuProfile

string

profile.cpuprofile

Emit a v8 CPU profile of the compiler run for debugging.

--generateTrace

string

Generates an event trace and a list of types.

--importHelpers

boolean

false

Allow importing helper functions from tslib once per project, instead of including them per-file.

--importsNotUsedAsValues

remove, preserve 또는 error

remove

Specify emit/checking behavior for imports that are only used for types.

--incremental

boolean

true if composite; false otherwise.

Save .tsbuildinfo files to allow for incremental compilation of projects.

--inlineSourceMap

boolean

false

Include sourcemap files inside the emitted JavaScript.

--inlineSources

boolean

false

Include source code in the sourcemaps inside the emitted JavaScript.

--isolatedDeclarations

boolean

false

Require sufficient annotation on exports so other tools can trivially generate declaration files.

--isolatedModules

boolean

true if verbatimModuleSyntax; false otherwise.

Ensure that each file can be safely transpiled without relying on other imports.

--jsx

preserve, react, react-native, react-jsx 또는 react-jsxdev

Specify what JSX code is generated.

--jsxFactory

string

React.createElement

Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'.

--jsxFragmentFactory

string

React.Fragment

Specify the JSX Fragment reference to use for fragements when targeting React JSX emit, e.g. 'React.Fragment' or 'Fragment'.

--jsxImportSource

string

react

Specify module specifier used to import the JSX factory functions when using jsx: react-jsx*.`

--keyofStringsOnly

boolean

false

Make keyof only return strings instead of string, numbers or symbols. Legacy option.

--lib

list

A list of bundled library declaration files which describe the target runtime environment.

--listEmittedFiles

boolean

false

Print the names of emitted files after a compilation.

--listFiles

boolean

false

Print all of the files read during the compilation.

--mapRoot

string

Specify the location where debugger should locate map files instead of generated locations.

--maxNodeModuleJsDepth

number

0

Specify the maximum folder depth used for checking JavaScript files from node_modules. Only applicable with allowJs.

--module

none, commonjs, amd, umd, system, es6/es2015, es2020, es2022, esnext, node16, nodenext 또는 preserve

CommonJS if target is ES5; ES6/ES2015 otherwise.

Specify what module code is generated.

--moduleDetection

legacy, auto 또는 force

"auto": Treat files with imports, exports, import.meta, jsx (with jsx: react-jsx), or esm format (with module: node16+) as modules.

Specify what method is used to detect whether a file is a script or a module.

--moduleResolution

classic, node10/node, node16, nodenext 또는 bundler

Classic if module is AMD, UMD, System, or ES6/ES2015; Matches if module is node16 or nodenext; Node otherwise.

Specify how TypeScript looks up a file from a given module specifier.

--moduleSuffixes

list

List of file name suffixes to search when resolving a module.

--newLine

crlf 또는 lf

lf

Set the newline character

--noCheck

boolean

false

Disable full type checking (only critical parse and emit errors will be reported).

--noEmit

boolean

false

Disable emitting files from a compilation.

--noEmitHelpers

boolean

false

Disable generating custom helper functions like __extends in compiled output.

--noEmitOnError

boolean

false

Disable emitting files if any type checking errors are reported.

--noErrorTruncation

boolean

false

Disable truncating types in error messages.

--noFallthroughCasesInSwitch

boolean

false

Enable error reporting for fallthrough cases in switch statements.

--noImplicitAny

boolean

true if strict; false otherwise.

Avoid introducing anys inside your codebase when a type could be specified

--noImplicitOverride

boolean

false

Ensure overriding members in derived classes are marked with an override modifier.

--noImplicitReturns

boolean

false

Enable error reporting for codepaths that do not explicitly return in a function.

--noImplicitThis

boolean

true if strict; false otherwise.

Enable error reporting when this is given the type any.

--noImplicitUseStrict

boolean

false

Disable adding 'use strict' directives in emitted JavaScript files.

--noLib

boolean

false

Disable including any library files, including the default lib.d.ts.

--noPropertyAccessFromIndexSignature

boolean

false

Enforces using indexed accessors for keys declared using an indexed type.

--noResolve

boolean

false

Disallow imports, requires or <reference>s from expanding the number of files TypeScript should add to a project.

--noStrictGenericChecks

boolean

false

Disable strict checking of generic signatures in function types.

--noUncheckedIndexedAccess

boolean

false

Add undefined to a type when accessed using an index.

--noUncheckedSideEffectImports

boolean

false

Check side effect imports.

--noUnusedLocals

boolean

false

Enable error reporting when local variables aren't read.

--noUnusedParameters

boolean

false

Raise an error when a function parameter isn't read.

--out

string

Deprecated setting. Use outFile instead.

--outDir

string

Specify an output folder for all emitted files.

--outFile

string

Specify a file that bundles all outputs into one JavaScript file. If declaration is true, also designates a file that bundles all .d.ts output.

--paths

object

A set of locations to look for imports in

--plugins

list

Specify a list of language service plugins to include.

--preserveConstEnums

boolean

true if isolatedModules; false otherwise.

Disable erasing const enum declarations in generated code.

--preserveSymlinks

boolean

false

Disable resolving symlinks to their realpath. This correlates to the same flag in node.

--preserveValueImports

boolean

false

Preserve unused imported values in the JavaScript output that would otherwise be removed.

--preserveWatchOutput

boolean

false

Disable wiping the console in watch mode.

--pretty

boolean

true

Enable color and formatting in TypeScript's output to make compiler errors easier to read.

--reactNamespace

string

React

Specify the object invoked for createElement. This only applies when targeting react JSX emit.

--removeComments

boolean

false

Disable emitting comments.

--resolveJsonModule

boolean

false

Enable importing .json files.

--resolvePackageJsonExports

boolean

true when moduleResolution is node16, nodenext, or bundler; otherwise false

Use the package.json 'exports' field when resolving package imports.

--resolvePackageJsonImports

boolean

true when moduleResolution is node16, nodenext, or bundler; otherwise false

Use the package.json 'imports' field when resolving imports.

--rootDir

string

Computed from the list of input files.

Specify the root folder within your source files.

--rootDirs

list

Computed from the list of input files.

Allow multiple folders to be treated as one when resolving modules.

--skipDefaultLibCheck

boolean

false

Skip type checking .d.ts files that are included with TypeScript.

--skipLibCheck

boolean

false

Skip type checking all .d.ts files.

--sourceMap

boolean

false

Create source map files for emitted JavaScript files.

--sourceRoot

string

Sets the root path for debuggers to find the reference source code

--stopBuildOnErrors

boolean

Skip building downstream projects on error in upstream project.

--strict

boolean

false

Enable all strict type checking options.

--strictBindCallApply

boolean

true if strict; false otherwise.

Check that the arguments for bind, call, and apply methods match the original function.

--strictBuiltinIteratorReturn

boolean

false, unless strict is set

Built-in iterators are instantiated with a TReturn type of undefined instead of any.

--strictFunctionTypes

boolean

true if strict; false otherwise.

When assigning functions, check to ensure parameters and the return values are subtype-compatible.

--strictNullChecks

boolean

true if strict; false otherwise.

When type checking, take into account null and undefined.

--strictPropertyInitialization

boolean

true if strict; false otherwise.

Check for class properties that are declared but not set in the constructor.

--stripInternal

boolean

false

Disable emitting declarations that have @internal in their JSDoc comments.

--suppressExcessPropertyErrors

boolean

false

Disable reporting of excess property errors during the creation of object literals.

--suppressImplicitAnyIndexErrors

boolean

false

Suppress noImplicitAny errors when indexing objects that lack index signatures.

--target

es3, es5, es6/es2015, es2016, es2017, es2018, es2019, es2020, es2021, es2022, es2023 또는 esnext

ES5

Set the JavaScript language version for emitted JavaScript and include compatible library declarations.

--traceResolution

boolean

false

Log paths used during the moduleResolution process.

--tsBuildInfoFile

string

.tsbuildinfo

The file to store .tsbuildinfo incremental build information in.

--typeRoots

list

Specify multiple folders that act like ./node_modules/@types.

--types

list

Specify type package names to be included without being referenced in a source file.

--useDefineForClassFields

boolean

true if target is ES2022 or higher, including ESNext; false otherwise.

Emit ECMAScript-standard-compliant class fields.

--useUnknownInCatchVariables

boolean

true if strict; false otherwise.

Default catch clause variables as unknown instead of any.

--verbatimModuleSyntax

boolean

false

Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting.

undefined

The TypeScript docs are an open source project. Help us improve these pages by sending a Pull Request

Contributors to this page:
MHMohamed Hegazy  (96)
DRDaniel Rosenwasser  (19)
ADAxel D  (14)
OTOrta Therox  (7)
RCRyan Cavanaugh  (7)
44+

Last updated: 2024년 10월 09일