TypeScript Начало работы

Код TypeScript транспилируется (преобразуется) в код JavaScript с помощью специального компилятора.

Преобразование TypeScript в JavaScript означает, что этот код может выполняться везде, где поддерживается 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 в любом проекте или директории.
  • Удобно для быстрого тестирования, изучения или одноразовых скриптов.
  • Некоторые редакторы автоматически обнаруживают установленный глобально компилятор.

Недостатки:

  • Различные машины (или коллеги) могут иметь разные версии глобальных пакетов.
  • Возможны проблемы совместимости версий с ожидаемым проектом.
  • Может потребоваться повышение прав на некоторых системах для установки глобально.
Лучшая практика — устанавливать TypeScript как зависимость разработки проекта и запускать его с помощью команды 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.