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.