Опции tsconfigExplained

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 signature; используйте скобки (obj["key"]).
⤢noImplicitReturns	Ошибка, когда один путь кода возвращает значение, а другой — нет.
⤢noFallthroughCasesInSwitch	Ошибка, когда case в switch проваливается в следующий без break.
Язык и модули
⤢target	Уровень генерируемого JavaScript (напр. ES2022); более новые цели дают меньше downleveling.
⤢lib	Доступные встроенные API (напр. ES2022, DOM, DOM.Iterable).
⤢module	Система модулей в генерируемом коде (напр. ESNext, CommonJS, NodeNext).
⤢module: nodenext	Настоящие правила Node: каждый файл выбирает CJS или ESM по ближайшему package.json, а относительным импортам нужны расширения файлов.
⤢moduleResolution	Как разрешаются пути импорта (напр. bundler, node, nodenext).
⤢moduleDetection	Когда файл считается модулем: auto (по наличию import/export), legacy или force (всегда).
⤢esModuleInterop	Разрешает стиль default-импорта из CommonJS-модулей (по умолчанию true в большинстве настроек).
⤢allowSyntheticDefaultImports	Разрешает default-импорты из модулей, экспортирующих только именованные значения (только на уровне типов).
⤢verbatimModuleSyntax	Импорты попадают в вывод ровно как записаны; импорты только типов должны использовать import type (TS 5).
⤢resolveJsonModule	Позволяет импортам загружать файлы .json как типизированные значения.
⤢allowJs	Включает файлы .js во входные данные компиляции.
⤢checkJs	Проверяет типы и в файлах .js, читая их JSDoc-комментарии; влечёт allowJs.
⤢jsx	Как компилируется .tsx: react-jsx (автоматический рантайм), react (React.createElement) или preserve.
⤢types	Ограничивает автоматически подключаемые пакеты @types этим списком; пустой массив не подключает ничего.
⤢typeRoots	Папки, сканируемые на пакеты @types, вместо всех node_modules/@types вверх по дереву.
⤢isolatedModules	Гарантирует, что каждый файл транспилируется изолированно (требуется бандлерами и esbuild).
Генерация кода
⤢outDir	Куда записывается скомпилированный JavaScript.
⤢rootDir	Корень исходных файлов; держит форму дерева вывода стабильной.
⤢sourceMap	Пишет файлы .js.map, чтобы отладчики отображали всё обратно в TypeScript.
⤢inlineSourceMap	Встраивает source map комментарием внутрь файла .js вместо отдельного файла .js.map.
⤢declaration	Пишет декларации типов .d.ts (нужно для библиотек).
⤢declarationMap	Пишет файлы .d.ts.map, чтобы редакторы переходили из деклараций обратно к исходнику TypeScript.
⤢emitDeclarationOnly	Пишет только файлы .d.ts; JavaScript остаётся бандлеру (требует declaration или composite).
⤢importHelpers	Переиспользует хелперы вроде __rest из tslib вместо вставки их в каждый файл.
⤢downlevelIteration	Корректные for..of, spread и деструктуризация по итерируемым, когда target ниже ES2015.
⤢removeComments	Вырезает комментарии из генерируемого JavaScript.
⤢noEmit	Только проверка типов; файлы не пишутся (используется, когда вывод делает бандлер).
Пути
⤢baseUrl	Базовый каталог для разрешения модулей по не-относительным путям.
⤢paths	Отображает префиксы импорта на расположения, напр. { "@/*": ["src/*"] }.
⤢rootDirs	Считает несколько каталогов одним виртуальным корнем при разрешении.
Структура проекта
⤢composite	Помечает проект как собираемый для project references (включает declaration, incremental).
⤢references	Зависимость от других проектов tsconfig ради более быстрых изолированных сборок.
⤢incremental	Сохраняет информацию сборки, чтобы в следующий раз пропустить неизменённые файлы.
Прочие проверки
⤢skipLibCheck	Пропускает проверку типов файлов .d.ts ради скорости (по умолчанию true).
⤢forceConsistentCasingInFileNames	Ошибка у импортов, расходящихся с реальным регистром имени файла.
⤢noUncheckedIndexedAccess	Доступ по индексу к массивам возвращает T | undefined, а не T.
⤢useDefineForClassFields	Поля классов создаются через Object.defineProperty вместо простого присваивания (по умолчанию true для целей ES2022+).
⤢experimentalDecorators	Включает устаревший синтаксис декораторов, на котором держатся старые фреймворки (до стандартизации).
⤢noErrorTruncation	Сообщает полные имена типов в ошибках вместо обрезания длинных.
⤢noUncheckedSideEffectImports	Ошибка, когда «голый» импорт ради побочного эффекта (import "./x.css") ничего не находит.
⤢allowImportingTsExtensions	Разрешает пути импорта, заканчивающиеся на .ts (требует noEmit или emitDeclarationOnly).