Паттерн Builder

Принципы

• Паттерн «строитель» позволяет поэтапно конфигурировать объект через цепочку методов, возвращающих this.
• Конструктор задаёт обязательные части, а методы добавляют опциональные признаки (addKetchup, addMustard).
• Возврат this из каждого метода делает API цепочечным и читабельным.

Пример

class HotDog {
  constructor(
    public bread: string,
    public ketchup?: boolean,
    public mustard?: boolean,
    public kraut?: boolean,
  ) {}

  addKetchup() {
    this.ketchup = true;
    return this;
  }
  addMustard() {
    this.mustard = true;
    return this;
  }
  addKraut() {
    this.kraut = true;
    return this;
  }
}

const myLunch = new HotDog('gluten free')
  .addKetchup()
  .addMustard()
  .addKraut();

Практика

• Возвращайте this, чтобы сохранить доступ к методам строителя; при наследовании используйте this как тип (this: this).
• Фиксируйте обязательные параметры в конструкторе: это гарантирует корректность итогового экземпляра.
• Для неизменяемых объектов создавайте новый экземпляр в каждом методе (return new HotDog(...this, { ketchup: true })).