TypeScript для новичка: зачем нужны типы

Какую проблему решают типы

В JavaScript переменная может содержать что угодно. Это удобно, пока проект маленький, и мучительно, когда он вырос.

Типичные беды: передали строку туда, где ждали число; обратились к полю, которого нет; функция иногда возвращает объект, а иногда ничего. Всё это выясняется во время работы программы, часто у пользователя.

Типы переносят такие ошибки на момент написания кода. Редактор подчёркивает проблему сразу, до запуска.

Второй эффект, который недооценивают: типы работают как документация. Глядя на описание функции, видно, что она принимает и что возвращает, — без чтения её кода.

Минимум для начала

Простые типы.

let title: string = "Заметка";
let count: number = 0;
let done: boolean = false;

Часто указывать не обязательно: если присваиваете значение сразу, тип выводится сам.

Массивы и объекты.

const tags: string[] = ["работа", "дом"];

type Note = {
  id: number;
  title: string;
  body?: string;
};

Вопросительный знак означает необязательное поле.

Функции.

function shorten(text: string, limit: number): string {
  return text.length > limit ? text.slice(0, limit) + "…" : text;
}

Объединения. Значение может быть одним из нескольких:

type Status = "new" | "in_progress" | "done";

Это одна из самых полезных возможностей: вместо строки, куда можно записать что угодно, вы получаете строгий набор допустимых значений.

Чего не делать на старте

Не отключайте проверки. Соблазн поставить тип «любой» при первой сложности велик, но так вы получаете обычный JavaScript с лишними символами.

Не увлекайтесь сложными конструкциями. Язык типов сам по себе довольно мощный, и можно писать в нём невероятные вещи. Для рабочих задач это почти никогда не нужно.

Не описывайте всё вручную. Многое выводится само. Указывайте типы там, где это граница: аргументы функций, возвращаемые значения, структуры данных.

Стоит ли новичку

Не первым делом. Сначала JavaScript до рабочего уровня: без понимания самого языка типы будут набором раздражающих ошибок.

Но и не откладывать надолго. В вакансиях типизация встречается всё чаще, а привыкать к ней проще на маленьких проектах, чем потом на большом чужом коде.

Разумный момент — когда вы сделали пару проектов на чистом JavaScript и начали путаться в собственных данных. Это ощущение и есть сигнал.

Как начать без боли

Возьмите свой существующий небольшой проект и переведите постепенно: сначала опишите структуры данных, потом аргументы функций. Полная строгость сразу — верный способ возненавидеть инструмент.

Через неделю такой работы обычно приходит понимание, зачем это нужно: редактор начинает подсказывать, а ошибки «не то поле» исчезают сами собой.