Типизация классов в TypeScript добавляет новый синтаксис определения классов, которого нет в JavaScript. Этот синтаксис существует только на уровне проверки типов. В результирующем коде он вырезается или заменяется. В этом уроке мы изучим реализацию таких классов.

Определение полей внутри класса

Начнем с примера. Посмотрите на этот класс:

class Point {
  x: number;

  y: number;

  constructor(x: number, y: number) {
    this.x = x;
    this.y = y;
  }
}

const p = new Point(10, 20);
console.log(p); // { x: 10, y: 20 }

Здесь мы видим новый синтаксис, который описывает поля класса: x и y. Их описание обязательно, потому что классы — это функции-конструкторы, а функции в TypeScript являются объектами.

Перед тем как двигаться дальше, разберемся с понятием «поле класса».

Поле класса

Обычно в JavaScript все называют свойствами. А слово «поле» используют как синоним те, кто пришел из других языков. Но это не одно и тоже.

Внутри класса мы определяем поля — это данные самого класса. А свойство — это то, с помощью чего мы взаимодействуем с объектом.

Часто свойства отображаются на поля напрямую, но так происходит не всегда. Например, свойство может быть геттером, который берет информацию из поля, тогда оно доступно только для чтения. Или свойство может быть сеттером, который устанавливает новое значение поля:

class Point {
  x: number;

  y: number;

  // Возвращаемый тип не указывается, потому что это конструктор
  constructor(x: number, y: number) {
    this.x = x;
    this.y = y;
  }

  get inspect(): string {
    return `(${this.x}, ${this.y})`;
  }
}

const p = new Point(2, 5);
// Свойство есть, а поля такого нет
console.log(p.inspect); // (2, 5)

В примере мы определили геттер inspect, который возвращает строку с координатами точки. Это свойство доступно только для чтения: сеттера у него нет.

Поля могут быть инициализированы сразу при определении класса. Это удобно, когда конструктор не нужен или данные не зависят от его вызова — задаются статически внутри:

class Point {
  x = 0;

  y = 0;
}

const p = new Point();
console.log(p); // { x: 0, y: 0 }

Как и в случае обычных переменных, тип полей выводится автоматически во время их инициализации, поэтому указывать явный тип не обязательно.

Реализуйте класс CustomFile, в конструктор которого передается объект с полями: name — именем файла, и size — размером в байтах. Переданные значения сохраните в публичных полях с теми же именами: name (строка) и size (число). Они должны быть доступны снаружи как свойства объекта.

Также внутри класса определите метод toString(), который должен вернуть форматированную строку в формате <file-name> (<size> bytes).

const file = new CustomFile({ name: "open-world.jpeg", size: 1000 });

console.log(file.name); // open-world.jpeg
console.log(file.size); // 1000
console.log(file.toString()); // open-world.jpeg (1000 bytes)