Типизация конструктора и перегрузка конструктора
На этой странице
Параметры конструктора типизируют так же, как параметры функции, а поля класса объявляют с типами в теле класса или через parameter properties (constructor(private api: Api)). Реализация конструктора в классе одна, но TypeScript позволяет описать несколько сигнатур перегрузки — разные варианты вызова new с одной общей реализацией. Часто вместо перегрузок удобнее статические фабричные методы.
Вопрос
Как типизировать конструктор класса в TypeScript? Можно ли перегрузить конструктор?
Типизация
class User {
id: string;
name: string;
email?: string;
constructor(id: string, name: string, email?: string) {
this.id = id;
this.name = name;
this.email = email;
}
}С strictPropertyInitialization поле без значения по умолчанию должно быть присвоено в конструкторе, иначе ошибка. Если поле инициализируется позже (например, в init()), используют !: db!: Database — но это обещание компилятору, а не проверка.
Parameter properties
class ApiClient {
constructor(
private readonly baseUrl: string,
private timeout = 5000,
) {}
get(path: string) {
return fetch(`${this.baseUrl}${path}`, { signal: AbortSignal.timeout(this.timeout) });
}
}Перегрузка конструктора
class Point {
x: number;
y: number;
constructor(); // сигнатура 1
constructor(x: number, y: number); // сигнатура 2
constructor(point: { x: number; y: number }); // сигнатура 3
constructor(a?: number | { x: number; y: number }, b?: number) { // реализация
if (typeof a === "object") {
this.x = a.x;
this.y = a.y;
} else {
this.x = a ?? 0;
this.y = b ?? 0;
}
}
}
new Point();
new Point(1, 2);
new Point({ x: 1, y: 2 });
new Point(1); // ошибка: нет такой сигнатурыСигнатура реализации снаружи не видна — вызывать можно только по объявленным перегрузкам.
Альтернатива: статические фабрики
class Money {
private constructor(readonly amount: number, readonly currency: string) {}
static rub(amount: number) {
return new Money(amount, "RUB");
}
static parse(text: string) {
const [amount, currency] = text.split(" ");
return new Money(Number(amount), currency);
}
}
Money.rub(100);
Money.parse("15 USD");
new Money(1, "RUB"); // ошибка: конструктор privateФабрики с понятными именами читаются лучше перегрузок, а private constructor запрещает создание в обход них.
Тип конструктора
type Constructor<T = object> = new (...args: any[]) => T;
function createAll<T>(Cls: Constructor<T>, count: number): T[] {
return Array.from({ length: count }, () => new Cls());
}
type Args = ConstructorParameters<typeof ApiClient>; // [baseUrl: string, timeout?: number]Что важно помнить
- Конструктор не может быть
asyncи не может иметь возвращаемый тип в аннотации. - В наследнике
super(...)нужно вызвать до обращения кthis, а параметры родителя тоже типизируются. private constructorиспользуют для синглтонов и фабрик.- Для многих необязательных параметров удобнее один объект настроек, чем перегрузки.
Мини-шпаргалка
- Параметры конструктора — как у функции, поля — с типами в классе.
- Parameter properties:
constructor(private x: T). - Перегрузка: несколько сигнатур + одна реализация.
- Альтернатива — статические фабрики и
private constructor. - Тип класса:
new (...args) => T,ConstructorParameters.
Документация
TypeScript Handbook: Constructors, TypeScript Handbook: Function Overloads.