Классы и перечисления

Добавляй в классы типизированные поля, управляй доступом через `public`, `private`, `protected` и `readonly`, проверяй соответствие интерфейсу через `implements` и сравни `enum` с объединением литеральных типов.

  • Средний
  • 17 мин
  • 10 вопросов
  • Урок 6 из 8

В этом уроке ты узнаешь

  • Объявлять поля класса вместе с их типами
  • Правильно выбирать между public, private, protected и readonly
  • Проверять класс на соответствие интерфейсу через implements и использовать свойства-параметры
  • Выбирать между enum и объединением литеральных типов

В курсе JavaScript мы написали класс BankAccount. У него было слабое место: любой код мог написать account.balance = 1000000, и ничто этому не мешало. TypeScript добавляет классам три вещи: типы полей, модификаторы доступа, которые определяют, кто к чему может обращаться, и проверку соответствия класса интерфейсу. А в конце урока мы сравним два способа описать фиксированный набор значений — enum и объединение литеральных типов.

Типизированные поля

В JavaScript достаточно было создать поле в конструкторе записью this.owner = owner. В TypeScript каждое поле нужно объявить в теле класса вместе с типом. Если этого не сделать, компилятор выдаст error TS2339: Property 'owner' does not exist on type 'BankAccount'. Параметры и возвращаемые значения методов типизируются так же, как у обычных функций.

TypeScript
class BankAccount {
  owner: string;
  balance: number;

  constructor(owner: string, balance = 0) {
    this.owner = owner;
    this.balance = balance;
  }

  deposit(amount: number): void {
    this.balance += amount;
  }
}

const account = new BankAccount('Aysel', 100);
account.deposit(50);
console.log(`${account.owner}: ${account.balance} AZN`);

account.balance = 1000000;
console.log(`${account.owner}: ${account.balance} AZN`);

Ожидаемый результат

Aysel: 150 AZN
Aysel: 1000000 AZN
С типами всё в порядке, но последние две строки показывают проблему: баланс можно снаружи сделать каким угодно.

Чтобы читать дальше, зарегистрируйся бесплатно

Остальные разделы урока, тест и заметки открываются с аккаунтом Educora. Регистрация занимает минуту, а прогресс сохраняется на всех твоих устройствах.

Модификаторы доступа

МодификаторКто может обращаться
publicвсе; так по умолчанию, если ничего не указано
privateтолько код внутри этого же класса
protectedсам класс и его классы-потомки
readonlyчитать могут все, а задать значение можно только при объявлении или в конструкторе
TypeScript
class BankAccount {
  readonly owner: string;
  private balance: number;

  constructor(owner: string, balance = 0) {
    this.owner = owner;
    this.balance = balance;
  }
}

const account = new BankAccount('Aysel', 100);
account.balance = 1000000;
account.owner = 'Murad';
Text
account.ts:12:9 - error TS2341: Property 'balance' is private and only accessible within class 'BankAccount'.

12 account.balance = 1000000;
           ~~~~~~~

account.ts:13:9 - error TS2540: Cannot assign to 'owner' because it is a read-only property.

13 account.owner = 'Murad';
           ~~~~~
Теперь баланс могут менять только методы самого класса, а имя владельца после открытия счёта не меняется.

protected-поле скрыто снаружи, но классы-потомки его видят. Сберегательному счёту нужен баланс родителя, чтобы начислить проценты:

TypeScript
class Account {
  protected balance = 0;

  deposit(amount: number): void {
    this.balance += amount;
  }
}

class SavingsAccount extends Account {
  addInterest(rate: number): number {
    this.balance += (this.balance * rate) / 100;
    return this.balance;
  }
}

const leyla = new SavingsAccount();
leyla.deposit(1000);
console.log(leyla.addInterest(5));
console.log(leyla.balance);
Text
savings.ts:19:19 - error TS2445: Property 'balance' is protected and only accessible within class 'Account' and its subclasses.

19 console.log(leyla.balance);
                     ~~~~~~~
Внутри SavingsAccount this.balance разрешён, а снаружи leyla.balance — нет.

implements и свойства-параметры

Запись class Square implements Shape — это просьба к компилятору: «проверь, что в этом классе есть всё, чего требует интерфейс Shape». Если забыть метод, ошибка будет показана прямо у класса, а не там, где используется интерфейс:

TypeScript
interface Shape {
  name: string;
  area(): number;
}

class Circle implements Shape {
  name = 'circle';
  radius: number;

  constructor(radius: number) {
    this.radius = radius;
  }

  area(): number {
    return Math.PI * this.radius ** 2;
  }
}

class Square implements Shape {
  name = 'square';
  side: number;

  constructor(side: number) {
    this.side = side;
  }
}
Text
shapes.ts:19:7 - error TS2420: Class 'Square' incorrectly implements interface 'Shape'.
  Property 'area' is missing in type 'Square' but required in type 'Shape'.

19 class Square implements Shape {
         ~~~~~~
TypeScript
class Circle {
  constructor(private radius: number, public label = 'circle') {}

  area(): number {
    return Math.PI * this.radius ** 2;
  }
}

const c = new Circle(2);
console.log(c.label, c.area().toFixed(2));

Ожидаемый результат

circle 12.57
Два поля — radius и label — объявлены и заполнены в одной строке.

enum или литеральные типы?

Перечисление (enum) — это набор связанных именованных констант. Если значения не заданы, члены нумеруются с 0; можно задать и строковые значения. Enum — одна из редких возможностей TypeScript, которая кроме типов создаёт код JavaScript: компилятор превращает его в настоящий объект.

TypeScript
enum Direction {
  Up,
  Down,
  Left,
  Right,
}

enum Status {
  Active = 'ACTIVE',
  Blocked = 'BLOCKED',
}

console.log(Direction.Left);
console.log(Direction[2]);
console.log(Status.Blocked);

Ожидаемый результат

2
Left
BLOCKED
У числового enum есть и обратное отображение: Direction[2] возвращает имя.
JavaScript
var Status;
(function (Status) {
    Status["Active"] = "ACTIVE";
    Status["Blocked"] = "BLOCKED";
})(Status || (Status = {}));
Из enum Status tsc создаёт такой код JavaScript: перечисление не удаляется, а остаётся в программе.

Чаще всего ту же задачу решает объединение литеральных типов. Оно полностью удаляется, значения — обычные строки, а ошибки компилятор ловит точно так же:

TypeScript
type Status = 'active' | 'blocked' | 'deleted';

function label(status: Status): string {
  switch (status) {
    case 'active':
      return 'Active user';
    case 'blocked':
      return 'Blocked';
    case 'deleted':
      return 'Deleted';
  }
}

console.log(label('blocked'));
label('banned');
Text
status.ts:15:7 - error TS2345: Argument of type '"banned"' is not assignable to parameter of type 'Status'.

15 label('banned');
         ~~~~~~~~
АспектenumОбъединение литеральных типов
Во время выполнениясоздаётся настоящий объектполностью удаляется
Запись значенияStatus.Blocked'blocked'
node file.ts (удаление типов)не поддерживаетсяработает
Получить все значения спискомвозможно через Object.values(Status)напрямую из типа нельзя

Запомни

  • В TypeScript каждое поле класса объявляется в теле вместе с типом.
  • public — все, private — только класс, protected — класс и потомки, readonly — только чтение.
  • private проверяется только при компиляции; для приватности во время выполнения есть поля #.
  • implements проверяет класс на соответствие интерфейсу; constructor(private x: T) — краткий способ объявить поле.
  • Enum создаёт настоящий объект JavaScript; объединение литеральных типов удаляется и чаще всего предпочтительнее.
Заметил ошибку или неточность в уроке?

Проверь себя

Вопросов: 10. Каждый правильный ответ приносит XP.

Вопрос 1 / 10

Вопрос 1 / 10. Какой модификатор разрешает обращаться к полю только из самого класса и его потомков?