tsconfig オプションExplained

55 of 55 rows

オプション↕	制御する内容↕
厳格性
⤢strict	マスタースイッチ：strictNullChecks、noImplicitAny など複数のオプションを一度に有効化。
⤢noImplicitAny	型を推論できないパラメータや変数でエラー（無効だと any になる）。
⤢strictNullChecks	null と undefined がすべての型に代入可能ではなくなり、明示的に扱う必要がある。
⤢strictFunctionTypes	関数パラメータを反変でチェック。不完全なコールバックパラメータの型を捕捉。
⤢strictBindCallApply	bind、call、apply を関数の宣言パラメータと照らして型チェック。
⤢strictPropertyInitialization	クラスプロパティが初期値を持たず、コンストラクタでも代入されない場合にエラー。
⤢exactOptionalPropertyTypes	オプションプロパティ { p?: T } が明示的な undefined の代入を受け付けなくなる。
⤢noImplicitOverride	基底クラスのメンバーを隠すメンバーに override キーワードを要求。
⤢noUnusedLocals	宣言されたのに一度も読まれないローカル変数でエラー。
⤢noUnusedParameters	宣言されたのに一度も読まれない関数パラメータでエラー。
⤢noUnusedExpressions	効果のない式文でエラー。
⤢noPropertyAccessFromIndexSignature	index シグネチャのキーへのドットアクセスを禁止。角括弧を使う（obj["key"]）。
⤢noImplicitReturns	あるコードパスが値を返すのに別のパスが返さないときエラー。
⤢noFallthroughCasesInSwitch	break なしで switch の case が次へ落ちるときエラー。
言語とモジュール
⤢target	JavaScript の生成レベル（例: ES2022）。新しい target ほど downleveling が減る。
⤢lib	利用できる組み込み API（例: ES2022、DOM、DOM.Iterable）。
⤢module	出力されるモジュールシステム（例: ESNext、CommonJS、NodeNext）。
⤢module: nodenext	Node の実際のルールを使う：各ファイルは最寄りの package.json から CJS か ESM を選び、相対 import には拡張子が必要。
⤢moduleResolution	import パスの解決方法（例: bundler、node、nodenext）。
⤢moduleDetection	ファイルがモジュールとみなされる条件：auto（import/export の有無）、legacy、force（常に）。
⤢esModuleInterop	CommonJS モジュールから default-import 形式を許可（多くの設定ではデフォルトで true）。
⤢allowSyntheticDefaultImports	名前付きの値しか export しないモジュールからの default import を許可（型レベルのみ）。
⤢verbatimModuleSyntax	import は書いたとおりに出力される。型専用の import は import type を使う必要がある（TS 5）。
⤢resolveJsonModule	import が .json ファイルを型付きの値として読み込めるようにする。
⤢allowJs	.js ファイルをコンパイルの入力に含める。
⤢checkJs	.js ファイルも JSDoc コメントを読みながら型チェックする。allowJs を暗黙に有効化。
⤢jsx	.tsx のコンパイル方法：react-jsx（自動ランタイム）、react（React.createElement）、preserve。
⤢types	自動で読み込まれる @types パッケージをこのリストに制限。空配列なら何も読み込まない。
⤢typeRoots	@types パッケージを探すフォルダ。ツリーを上がってすべての node_modules/@types を見る代わり。
⤢isolatedModules	すべてのファイルが単独でトランスパイル可能であることを保証（bundler と esbuild が要求）。
出力 (emit)
⤢outDir	コンパイル済み JavaScript の出力先。
⤢rootDir	ソースファイルのルート。出力ツリーの形状を安定させる。
⤢sourceMap	.js.map ファイルを出力し、デバッガが TypeScript に対応付ける。
⤢inlineSourceMap	source map を .js.map ではなく .js ファイル内のコメントとして埋め込む。
⤢declaration	.d.ts 型宣言を出力する（ライブラリに必要）。
⤢declarationMap	.d.ts.map ファイルを出力し、エディタが宣言から TypeScript ソースへジャンプできるようにする。
⤢emitDeclarationOnly	.d.ts ファイルのみ出力。JavaScript は bundler に任せる（declaration か composite が必要）。
⤢importHelpers	__rest のようなヘルパーを各ファイルに書き込まず tslib から再利用する。
⤢downlevelIteration	target が ES2015 未満のとき、iterable の for..of、spread、分割代入を正しく処理。
⤢removeComments	出力される JavaScript からコメントを取り除く。
⤢noEmit	型チェックのみを行い、ファイルを書き出さない（bundler が emit を担う場合に使用）。
パス
⤢baseUrl	非相対モジュール解決のベースディレクトリ。
⤢paths	import のプレフィックスを場所に対応付ける。例: { "@/*": ["src/*"] }。
⤢rootDirs	複数のディレクトリを解決用の単一の仮想ルートとして扱う。
プロジェクト構成
⤢composite	プロジェクトを project reference 向けにビルド可能とマーク（declaration と incremental を有効化）。
⤢references	他の tsconfig プロジェクトに依存し、より速く分離されたビルドを実現する。
⤢incremental	ビルド情報を保存し、次回の実行で変更のないファイルの再チェックを省く。
その他のチェック
⤢skipLibCheck	速度のため .d.ts ファイルの型チェックを省略（デフォルトで true）。
⤢forceConsistentCasingInFileNames	ファイルの実際の大文字小文字と一致しない import でエラー。
⤢noUncheckedIndexedAccess	配列とインデックスアクセスが T ではなく T | undefined を返す。
⤢useDefineForClassFields	クラスフィールドを単純な代入ではなく Object.defineProperty で生成（ES2022+ の target ではデフォルトで true）。
⤢experimentalDecorators	古いフレームワークが使うレガシーなデコレータ構文を有効化（標準化以前）。
⤢noErrorTruncation	長い型名を省略せず、エラーメッセージに完全な型名を表示する。
⤢noUncheckedSideEffectImports	副作用のみの import（import "./x.css"）が何にも解決されないときエラー。
⤢allowImportingTsExtensions	.ts で終わる import パスを許可（noEmit か emitDeclarationOnly が必要）。