Risposta.

In TypeScript, la corretta tipizzazione di this è fondamentale per supportare il pattern method chaining, in cui i metodi restituiscono this per chiamate successive. Se non si specifica esplicitamente il tipo di ritorno, TypeScript considera per default l'oggetto restituito un'istanza della classe corrente, il che è errato in caso di ereditarietà.

Per risolvere questo problema si utilizza this polimorfico (polymorphic this types) tramite il ritorno di 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 è correttamente visibile

Il tipo restituito this garantisce che la catena di metodi sia correttamente tipizzata anche per gli eredi, e non solo per la classe base.

Domanda trabocchetto.

Si può invece usare il nome della classe (ad esempio, restituire Builder) nel tipo di ritorno? Come influiscerà sulle catene di metodi negli eredi?

Risposta:

Se restituisci Builder invece di 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 non è visibile!

multiply sarà non accessibile dopo setValue, perché setValue restituirà Builder, e non AdvancedBuilder. Solo this nella firma del metodo mantiene la corretta tipizzazione nella catena di metodi.

Esempi di errori reali causati dalla mancanza di conoscenza delle sottigliezze dell'argomento

---

Storia

Nel team di sviluppo, è stata creata un'API fluente per la costruzione di configurazioni. Nei metodi si restituiva il tipo della classe base, ritenendo fosse una buona pratica. Dopo l'arrivo di un erede nell'API fluente, tutti i metodi aggiuntivi divennero invisibili dopo la catena di chiamate standard. Risultato: è stato necessario refattorizzare l'API su this, affinché i clienti potessero utilizzare le estensioni.

---

Storia

Nella libreria interna di decoratori, restituivano esplicitamente un tipo concreto della classe. Gli utenti, utilizzando gli eredi, perdevano accesso ai nuovi metodi, ricevendo "object has no method ...". L'errore si è presentato solo durante l'integrazione con i nuovi servizi.

---

Storia

Uno sviluppatore, copiando metodi da un vecchio API C#, ha riscritto la catena di metodi in TypeScript, restituendo il nome della classe. Durante la fase di build tutto sembrava normale, ma negli eredi degli utenti si perdevano nuovi metodi. Solo un rigoroso controllo in tsconfig ha aiutato a identificare rapidamente questo problema — e a correggerlo in modo da restituire this.