Ответ.

В TypeScript корректная типизация this критически важна для поддержки паттерна method chaining, когда методы возвращают this для последовательных вызовов. Если не указать явно тип возвращаемого значения, TypeScript по умолчанию считает возвращаемый объект экземпляром текущего класса, что неверно при наследовании.

Для решения этой задачи используют полиморфный this (polymorphic this types) через возвращаемый this:

class Builder {
  value: number = 0;
  setValue(v: number): this {
    this.value = v;
    return this;
  }
}

class AdvancedBuilder extends Builder {
  multiply(factor: number): this {
    this.value *= factor;
    return this;
  }
}

const b = new AdvancedBuilder().setValue(5).multiply(2); // multiply корректно виден

returned type this гарантирует, что цепочка методов корректно типизирована даже для наследников, а не только для базового класса.

Вопрос с подвохом.

Можно ли вместо использования this в типе возвращаемого значения просто указывать имя класса (например, возвращать Builder)? Как это повлияет на цепочки методов в наследниках?

Ответ:

Если вы вернёте Builder вместо this:

class Builder {
  setValue(v: number): Builder {
    //...
    return this;
  }
}

class AdvancedBuilder extends Builder {
  multiply(factor: number): this {
    // ...
    return this;
  }
}

const a = new AdvancedBuilder().setValue(2).multiply(2); // multiply не виден!

multiply будет недоступен после setValue, потому что setValue вернёт Builder, а не AdvancedBuilder. Только this в сигнатуре метода сохраняет правильную типизацию в цепочке методов.

Примеры реальных ошибок из-за незнания тонкостей темы

---

История

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

---

История

Во внутренней библиотеке декораторов возвращали явно конкретный тип класса. Пользователи при использовании наследников теряли доступ к новым методам, получая "object has no method ...". Ошибка возникла только при интеграции с новыми сервисами.

---

История

Разработчик, копируя методы из старого C# API, переписал цепочку методов на TypeScript, возвращая имя класса. В билд-стадии всё выглядело нормально, но в пользовательских наследниках терялись новые методы. Только строгая проверка в tsconfig помогла быстро выявить эту проблему — и исправить на возвращаемый this.