Перегрузка методов

Принципы

• Объявляйте несколько сигнатур метода с разными типами аргументов и возвращаемых значений.
• Реализация должна быть совместима со всеми перегрузками и обычно использует объединённые типы (any, unknown).
• Возвращайте соответствующие значения в зависимости от комбинации параметров.

Пример

class Person {
  add(a: number, b: number): number;
  add(a: string, b: string): string;
  add(a: Date, b: Date): Date;
  add(a: any, b: any) {
    if (typeof a === 'number' && typeof b === 'number') {
      return a + b;
    }
    if (typeof a === 'string' && typeof b === 'string') {
      return a + b;
    }
    if (a instanceof Date && b instanceof Date) {
      return new Date(a.getTime() + b.getTime());
    }
  }
}

Практика

• В реализации проверяйте все ветки и возвращайте значение, чтобы избежать undefined.
• Используйте перегрузки для API, которые принимают разные формы данных (строки, числа, объекты).
• Документируйте каждую перегрузку; IDE покажет подходящую сигнатуру при вызове.