7.1 Компиляция TypeScript кода
TypeScript CLI (Command Line Interface) предоставляет множество команд для управления процессом разработки, компиляции и наблюдения за файлами. Ниже мы подробно рассмотрим основные команды TypeScript CLI, которые помогут вам эффективно работать с TypeScript проектами.
Компиляция TypeScript кода
Основная функция TypeScript CLI — это компиляция TypeScript кода в JavaScript. Давайте рассмотрим, как это делается.
1. Компиляция одного файла
Для компиляции одного TypeScript файла используйте команду tsc, за которой следует имя файла:
tsc hello.ts
Эта команда скомпилирует файл hello.ts и создаст файл hello.js со скомпилированным JavaScript кодом.
2. Компиляция нескольких файлов
Вы также можете скомпилировать несколько файлов одновременно, указав их имена через пробел:
tsc file1.ts file2.ts
Эта команда скомпилирует оба файла и создаст соответствующие файлы JavaScript.
3. Компиляция с использованием файла tsconfig.json
Для более сложных проектов обычно используется файл конфигурации tsconfig.json, который содержит все настройки компиляции. Чтобы скомпилировать проект, используя этот файл, просто выполните команду tsc без аргументов:
tsc
Компилятор автоматически найдет файл tsconfig.json в текущей директории и использует его настройки для компиляции проекта.
4. Компиляция в определенную директорию
Вы можете указать директорию для вывода скомпилированных файлов с помощью флага --outDir:
tsc --outDir ./dist
Эта команда скомпилирует все файлы TypeScript и поместит скомпилированные файлы JavaScript в директорию dist.
5. Генерация source maps
Source maps помогают при отладке кода, связывая скомпилированный JavaScript код с исходным TypeScript кодом. Для генерации source maps используйте флаг --sourceMap:
tsc --sourceMap
Эта команда создаст файлы .map, которые можно использовать для отладки в браузере или других инструментах отладки.
7.2 Наблюдение за изменениями в файлах
TypeScript CLI предоставляет мощную возможность наблюдения за файлами, которая автоматически перекомпилирует ваш код при изменении файлов. Это особенно полезно при разработке, так как позволяет сократить время на ручную компиляцию.
1. Использование флага --watch
Для включения режима наблюдения используйте флаг --watch (или сокращенно -w):
tsc --watch
Теперь компилятор будет следить за изменениями в файлах и автоматически их перекомпилировать. Вы увидите вывод в терминале, который уведомит вас о начале и завершении компиляции.
Пример:
Создайте файл greet.ts со следующим содержимым:
// greet.ts
function greet(name: string): string {
return `Hello, ${name}!`;
}
console.log(greet('World'));
Запустите компилятор в режиме наблюдения:
tsc --watch greet.ts
Теперь откройте файл greet.ts, внесите изменения и сохраните его. Например, измените строку приветствия:
console.log(greet('TypeScript'));
Компилятор автоматически перекомпилирует файл, и вы увидите обновленный вывод в терминале.
2. Наблюдение за проектом с tsconfig.json
Вы также можете использовать режим наблюдения для проектов с файлом tsconfig.json:
tsc --watch
Компилятор будет следить за всеми файлами, указанными в конфигурации, и автоматически перекомпилировать их при изменении.
7.3 Дополнительные команды TypeScript CLI
Помимо основных команд компиляции и наблюдения, TypeScript CLI предоставляет множество других полезных команд и флагов.
1. Помощь по командам
Для получения списка всех доступных команд и флагов используйте команду tsc --help:
tsc --help
Эта команда выведет справочную информацию по всем командам и флагам, которые можно использовать с TypeScript CLI.
2. Проверка версий
Для проверки текущей версии TypeScript используйте команду tsc -v:
tsc -v
Эта команда выведет версию установленного TypeScript компилятора.
3. Флаг noEmit
Флаг --noEmit указывает компилятору не генерировать выходные файлы. Это полезно, когда вы хотите просто проверить ваш код на наличие ошибок, но не хотите создавать скомпилированные файлы.
tsc --noEmit
4. Флаг watchDirectory
Флаг --watchDirectory позволяет указать директорию, за изменениями в которой будет следить компилятор. Это полезно, если вы хотите ограничить область наблюдения.
tsc --watchDirectory ./src
5. Инкрементальная компиляция
Инкрементальная компиляция позволяет ускорить процесс компиляции за счет повторного использования информации о предыдущих компиляциях. Для включения инкрементальной компиляции используйте флаг --incremental:
tsc --incremental
Компилятор создаст файл .tsbuildinfo, который будет содержать информацию для инкрементальной компиляции.
6. Вывод диагностики
Чтобы получить более детальную информацию о процессе компиляции используйте флаг --diagnostics. Это выведет статистику о времени компиляции, использовании памяти и других параметрах.
tsc --diagnostics
ПЕРЕЙДИТЕ В ПОЛНУЮ ВЕРСИЮ