Код TypeScript транспилируется (преобразуется) в код JavaScript с помощью специального компилятора.
Установка компилятора
Официальный компилятор TypeScript устанавливается через пакетный менеджер npm.
Чтобы установить компилятор в ваш проект, выполните следующую команду:
Пример
npm install typescript --save-dev
Компилятор устанавливается в папку node_modules и запускается командой: npx tsc.
Пример
npx tsc
Результат выполнения команды выглядит следующим образом (версия может быть другой):
Пример
Version 4.5.5
tsc: The TypeScript Compiler - Version 4.5.5
Далее идет список всех стандартных команд.
Глобальная установка
При установке TypeScript глобально команда tsc добавляется в системный PATH, благодаря чему доступна из любого каталога.
Пример
npm install -g typescript
Пример
tsc -v
Преимущества:
- Быстрая доступность команды
tscв любом проекте или директории. - Удобно для быстрого тестирования, изучения или одноразовых скриптов.
- Некоторые редакторы автоматически обнаруживают установленный глобально компилятор.
Недостатки:
- Различные машины (или коллеги) могут иметь разные версии глобальных пакетов.
- Возможны проблемы совместимости версий с ожидаемым проектом.
- Может потребоваться повышение прав на некоторых системах для установки глобально.
npx tsc, чтобы обеспечить согласованность версий в разных средах. Установка глобально удобна лишь для эпизодического использования.
Настройка компилятора
По умолчанию при запуске в пустом проекте компилятор TypeScript выводит справочное сообщение.
Настроить компилятор можно с помощью файла конфигурации tsconfig.json.
Создать файл tsconfig.json с рекомендуемыми настройками можно при помощи команды:
Пример
npx tsc --init
Больше информации о настройках конфигурационного файла TypeScript можно найти в соответствующем разделе далее.
Вот пример расширенной настройки файла tsconfig.json:
Пример
{
"include": ["src"],
"compilerOptions": {
"outDir": "./build"
}
}
Откройте файл в редакторе, чтобы добавить указанные опции.
Эта настройка заставит компилятор TypeScript транспилировать файлы TypeScript, расположенные в каталоге src вашего проекта, в файлы JavaScript в каталог build.
Ваша первая программа на TypeScript
Давайте создадим простую программу "Hello, World!", чтобы проверить вашу установку TypeScript.
Создайте новый файл с именем hello.ts и вставьте следующее содержимое:
hello.ts
function greet(name: string): string {
return `Hello, ${name}!`;
}
const message: string = greet("World");
console.log(message);
Скомпилируйте ваш код TypeScript:
Пример
npx tsc hello.ts
Это создаст файл hello.js в той же директории:
Пример
function greet(name) {
return "Hello, ".concat(name, "!");
}
const message = greet("World");
console.log(message);
Запустите полученный JavaScript файл:
Пример
node hello.js
Вы увидите следующий вывод:
Пример
Hello, World!
tsconfig.json, указанный ранее, поместите ваши файлы TypeScript в каталог src, а скомпилированные файлы JavaScript появятся в каталоге build.