Table of Contents #
Опции компилятора
Опция | Тип | Значение по умолчанию | Описание
-----------------------------------------------|-----------|--------------------------------|----------------------------------------------------------------------
--allowJs | boolean | true | Позволяет компилировать JavaScript-файлы.
--allowSyntheticDefaultImports | boolean | module === "system" | Позволяет использовать импорт по умолчанию из модулей без экспорта по умолчанию. Не влияет на генерируемый код, только на проверку типов.
--allowUnreachableCode | boolean | false | Не сообщать об ошибках при обнаружении недоступного для выполнения кода.
--allowUnusedLabels | boolean | false | Не сообщать об ошибках при обнаружении неиспользуемых меток.
--baseUrl | string | | Базовая директория для разрешения имен модулей, не являющихся относительными. См. Разрешение модулей для большей информации.
--charset | string | "utf8" | Кодировка входных файлов.
--declaration-d | boolean | false | Создает соответствующие файлы .d.ts.
--declarationDir | string | | Выходная директория для генерируемых файлов определений.
--diagnostics | boolean | false | Показывать диагностическую информацию.
--disableSizeLimit | boolean | false | Отключить ограничение размера для JavaScript-проектов.
--emitBOM | boolean | false | Добавлять метку порядка байтов (BOM) для создаваемых UTF-8 файлов.
--emitDecoratorMetadata[1] | boolean | false | Добавлять метаданные времени разработки (т. е., доступные еще до выполнения сгенерированного кода) для декорированных объявлений. См. issue #2577 для большей информации.
--experimentalDecorators[1] | boolean | false | Включает экспериментальную поддержку декораторов из ES7.
--forceConsistentCasingInFileNames | boolean | false | Запрещает использовать различающиеся регистром ссылки на один и тот же файл.
--help-h | | | Показать справочную информацию.
--inlineSourceMap | boolean | false | Генерировать карту кода в том же файле, что и код, а не в отдельном.
--inlineSources | boolean | false | Внедрять исходный код в файл с картой кода; требует установки --inlineSourceMap или --sourceMap.
--init | | | Инициализирует TypeScript проект и создает файл tsconfig.json.
--isolatedModules | boolean | false | Безоговорочно добавлять в код импорты для неразрешенных файлов.
--jsx | string | "Preserve" | Поддержка JSX в файлах .tsx. 'React' или 'Preserve'. См. JSX.
--lib | string[]| | Список файлов библиотек, включаемых в компиляцию. Допустимые значения:
► es5
► es6
► es2015
► es7
► es2016
► es2017 dom 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.sharedmemory
--listEmittedFiles | boolean | false | Выводить имена генерируемых файлов во время компиляции.
--listFiles | boolean | false | Выводить имена файлов во время компиляции.
--locale | string | (зависит от платформы) | Локаль для сообщений об ошибках, например en-us.
--mapRoot | string | | Указывает местоположение, где отладчик должен искать карты кода вместо сгенерированного. Использовать данный флаг, если .map файлы во время выполнения будут находиться не там, где .js файлы. Указанный путь будет внедрен в директиву sourceMap, указывая отладчику местоположение карт кода.
--module-m | string | target === 'ES6' ? 'ES6' : 'commonjs' | Указывает тип генерируемых модулей: 'none', 'commonjs', 'amd', 'system', 'umd', 'es6', or 'es2015'.
► Только 'amd' и 'system' могут быть использованы с --outFile.
► 'es6' и 'es2015' не могут быть использованы при генерации кода для ES5 и ниже.
--moduleResolution | string | module === 'amd' | 'system' | 'ES6' ? 'classic' : 'node' | Указывает метод разрешения модулей. Либо 'node' для разрешения в стиле Node.js/io.js, либо 'classic'. См. Разрешение модулей для большей информации.
--newLine | string | (зависит от платформы) | Использовать указанный формат перевода строк для создаваемых файлов: 'crlf' (windows) or 'lf' (unix)."
--noEmit | boolean | false | Не создавать выходных файлов.
--noEmitHelpers | boolean | false | Не генерировать вспомогательные функции наподобие __extends в выходных файлах.
--noEmitOnError | boolean | false | Не создавать выходных файлов, если были ошибки.
--noFallthroughCasesInSwitch | boolean | false | Сообщать об ошибке при "проваливающихся" условиях в switch.
--noImplicitAny | boolean | false | Сообщать об ошибке при выражениях и объявлениях с подразумеваемым типом any.
--noImplicitReturns | boolean | false | Сообщать об ошибке, если не все пути в функции возвращают значение.
--noImplicitThis | boolean | false | Сообщать об ошибке при выражениях с this с подразумеваемым типом any.
--noImplicitUseStrict | boolean | false | Не добавлять директиву use strict в код генерируемых модулей.
--noLib | boolean | false | Не включать файл библиотеки по умолчанию (lib.d.ts).
--noResolve | boolean | false | Не добавлять в список компилируемых файлов файлы, на которые код ссылается с помощью ссылок с тройной косой чертой или импорта.
--noUnusedLocals | boolean | false | Сообщать об ошибках при неиспользуемых локальных переменных.
--noUnusedParameters | boolean | false | Сообщать об ошибках при неиспользуемых параметрах.
~~--out~~ | string | | УСТАРЕЛО. Используйте --outFile.
--outDir | string | | Перенаправить вывод в указанную директорию.
--outFile | string | | Объединить и вывести все в один файл. Порядок объединения определяется списком входных файлов, переданном через командную строку, а также ссылками с тройной косой чертой и импортом. См. документацию о порядке файлов для большей информации.
paths[2] | Object | | Список соответствий имен модулей путям, относительным к baseUrl. См. Разрешение модулей для большей информации.
--preserveConstEnums | boolean | false | Не удалять объявления константных перечислений из сгенерированного кода. См. документацию на константные перечисления для большей информации.
--pretty[1] | boolean | false | Стилизовать цветом ошибки и сообщения в зависимости от контекста.
--project-p | string | | Компилировать проект, используя указанный корректный конфигурационный файл.
Аргумент может быть либо путем к корректному JSON-файлу конфигурации, либо к директории, содержащей файл tsconfig.json.
См. документацию о tsconfig.json для большей информации.
--reactNamespace | string | "React" | Указывает объект, на котором будут вызваны методы createElement и __spread при генерации React JSX.
--removeComments | boolean | false | Удалить все комментарии, кроме заголовка, начинающегося с /*! (копирайт).
--rootDir | string | (общая корневая директория вычисляется на основании списка входных файлов) | Указывает корневую директорию для входных файлов. Используется только для управления структурой выходной директории с --outDir.
rootDirs[2] | string[]| | Список корневых директорий, чье объединенное содержимое отражает структуру проекта во время выполнения. См. Разрешение модулей для большей информации.
--skipLibCheck | boolean | false | Не проверять правильность файла библиотеки по умолчанию (lib.d.ts).
--skipDefaultLibCheck | boolean | false | Не проверять правильность файла пользовательской библиотеки по умолчанию (*.d.ts).
--sourceMap | boolean | false | Генерирует соответствующий .map файл.
--sourceRoot | string | | Указывает местоположение, где отладчик должен искать файлы TypeScript вместо директории с исходными файлами. Использовать данный флаг, если исходные файлы во время выполнения будут находиться в ином месте, нежели во время разработки. Указанный путь будет внедрен в директиву sourceMap, указывая отладчику местоположение исходных файлов.
--strictNullChecks | boolean | false | Включает режим строгой проверки на null, в котором null и undefined не включаются во все типы, и могут быть присвоены только к самим себе и к any (с одним исключением — undefined также может присваиваться к void).
--stripInternal[1] | boolean | false | Не создавать определения для кода с JSDoc-аннотацией /** @internal */.
--suppressExcessPropertyErrors | boolean | false | Отключить проверку на избыточные свойства объектных литералов.
--suppressImplicitAnyIndexErrors | boolean | false | Подавлять ошибки --noImplicitAny для индексируемых объектов без сигнатуры индекса. См. issue #1232 для большей информации.
--target-t | string | "ES3" | Указать версию ECMAScript, для которой будет генерироваться код: 'es3' (по умолчанию), 'es5', или 'es6'.
--traceResolution | boolean | false | Выводить статусные сообщения для разрешения модулей.
--types | string[]| | Список включаемых имен определений типов.
--typeRoots | string[]| | Список директорий, откуда будут включаться определения типов.
--version-v | | | Вывести версию компилятора.
--watch-w | | | Запустить компилятор в режиме слежения. Следит за входными файлами и запускает перекомпиляцию в случае их изменения.
- [1] Экспериментальные опции.
- [2] Данные опции допускаются только в файле
tsconfig.json, но не в командной строке.
Связанные темы
- Установка опций компилятора в файлах
tsconfig.json. - Установка опций компилятора в проектах MSBuild.
Поддержите перевод документации:
Documentation generated by mdoc.